home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / bbs / maxs152.lha / MAXsBBS.manual < prev    next >
Text File  |  1992-12-26  |  168KB  |  3,650 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                      *******************************************
  23.                      *                                         *
  24.                      *   |\ /|   /\   \ / ' __    __  __  __   *
  25.                      *   | V |  /__\   X   (_    |__)|__)(_    *
  26.                      *   |   | /    \ / \  __)   |__)|__)__)   *
  27.                      *                                         *
  28.                      *         Version 1.00  14-Jul-91         *
  29.                      *                                         *
  30.                      *        Created by Anthony Barrett       *
  31.                      *                                         *
  32.                      *******************************************
  33.  
  34.  
  35.  
  36.                          Copyright © 1992 by Anthony Barrett
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                       CONTENTS
  45.                                       --------
  46.  
  47.  
  48.        1.  INTRODUCTION..................................................   1
  49.  
  50.  
  51.        2.  INSTALLATION..................................................   3
  52.  
  53.            Hard drive installation.......................................   3
  54.            Starting the BBS..............................................   4
  55.  
  56.  
  57.        3.  CONFIGURING THE BBS...........................................   5
  58.  
  59.            System configure..............................................   5
  60.            Modem configure...............................................  10
  61.            Menu editor...................................................  12
  62.            Sections configure............................................  14
  63.            User defaults.................................................  16
  64.            Text editor...................................................  17
  65.            Macros........................................................  19
  66.            FidoNet configure.............................................  19
  67.            FidoNet mail distribution.....................................  23
  68.            
  69.  
  70.        4.  PULL DOWN MENU FUNCTIONS......................................  25
  71.  
  72.            Local login...................................................  25
  73.            Chat on/off...................................................  25
  74.            Chat interrupt................................................  26
  75.            Countdown.....................................................  26
  76.            Printer/Output................................................  26
  77.            Text import...................................................  26
  78.            TWIT..........................................................  27
  79.            Caller log....................................................  27
  80.            About. . .....................................................  28
  81.            Iconify.......................................................  28
  82.            Quit..........................................................  29
  83.            Add 15 mins...................................................  29
  84.            Online edit...................................................  29
  85.            User editor...................................................  29
  86.            Files editor..................................................  35
  87.            Check files...................................................  38
  88.            Optimize messages.............................................  38
  89.            PURGE MESSAGES................................................  39
  90.            Force FidoNet.................................................  39
  91.            Force execute.................................................  39
  92.            Force msg import..............................................  39
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.        5.  BBS MENU FUNCTIONS............................................  41
  103.  
  104.            Function 1 - Log out..........................................  41
  105.            Function 2 - Goto menu........................................  42
  106.            Function 3 - Chat call........................................  42
  107.            Function 4 - Set ANSI flag....................................  42
  108.            Function 5 - Set CLS flag.....................................  42
  109.            Function 6 - Set pause flag...................................  43
  110.            Function 7 - Set FSE flag.....................................  43
  111.            Function 8 - Change # of lines per screen.....................  43
  112.            Function 9 - Change suburb....................................  43
  113.            Function 10 - Change phone number.............................  43
  114.            Function 11 - Change computer description.....................  43
  115.            Function 12 - Change password.................................  43
  116.            Funciion 13 - Type a file.....................................  44
  117.            Function 14 - Type a file without pause.......................  44
  118.            Function 15 - Print text......................................  44
  119.            Function 16 - Leave a message.................................  44
  120.            Fucntion 17 - Read messages...................................  45
  121.            Function 18 - List/Search user file...........................  47
  122.            Function 19 - Print caller log................................  47
  123.            Function 20 - List files......................................  47
  124.            Function 21 - Delete a file...................................  47
  125.            Function 22 - Read a file.....................................  48
  126.            Function 23 - Upload files....................................  48
  127.            Function 24 - Download files..................................  49
  128.            Function 25 - Make "New" file public..........................  50
  129.            Function 26 - Edit a user.....................................  50
  130.            Function 27 - Execute external program........................  50
  131.            Function 28 - CLI.............................................  51
  132.            Function 29 - Deposit to the time bank........................  51
  133.            Function 30 - Withdraw from the time bank.....................  51
  134.            Function 31 - Deposit all time remaining and log out..........  52
  135.            Function 32 - Send a private echo message.....................  52
  136.            Function 33 - Set default file transfer protocol..............  52
  137.            File transfer.................................................  52
  138.  
  139.  
  140.        6.  CUSTOMIZING THE BBS...........................................  55
  141.  
  142.            ANSI codes....................................................  56
  143.            Auto insert...................................................  58
  144.            Hiding parts of text..........................................  59
  145.  
  146.  
  147.  
  148.  
  149.      Chapter 1                    M A X's BBS                       Page: 1
  150.  
  151.                                   INTRODUCTION
  152.                                   ------------
  153.  
  154.      Thank  you for using M A X'S BBS!  This program is the result of three
  155.      year's worth of programming.  It was developed due to the lack of true
  156.      Amiga  BBS  programs  ie.  not  ported  from the IBM.   M A X's BBS is
  157.      Copyright  ©  1992  by  Anthony  Barrett.   This program is now Public
  158.      Domain and may be freely distributed.  ...............................
  159.      ......................................................................
  160.      ................................................................   M A
  161.      X's BBS SHALL NOT BE USED TO SPREAD COPYRIGHT MATERIAL  OR  SOFTWARE. 
  162.      NO RESPONSIBILITY IS ACCEPTED FOR DAMAGES ARISING FROM THE USE OF THIS
  163.      PROGRAM.  ............................................................
  164.      ......................................................................
  165.      ......................................................................
  166.      ......................................................................
  167.      ......................................................................
  168.      ......................................................................
  169.      ......................................................................
  170.      ......................................................................
  171.      ......................................................................
  172.  
  173.      BBS stands for Bulletin Board Service.   BBS's became popular when the
  174.      first  300  bps  modem  became available at an affordable price.   The
  175.      first BBS I called was "The Omen" and I was an  enthusiast  from  then
  176.      on.   I  had  a  Dick  Smith System-80 and a Dick Smith 300 bps manual
  177.      modem.   I think "The Omen" BBS  is  still  running  today.   The  BBS
  178.      software  back  then  was  very  basic  with  only the XModem checksum
  179.      protocol available for file transfers.   Since then,  BBS software has
  180.      become more advanced with the introduction of full screen editors, The
  181.      ZModem file transfer protocol and FidoNet echo mail  linking  all  the
  182.      BBS systems together.
  183.  
  184.      This  program was written for the Amiga,  and makes use of the Amiga's
  185.      graphical user interface called "Intuition".   Some Amiga BBS programs
  186.      which  were  ported  from the IBM environment are menu driven,  making
  187.      them slow and awkward to use.   The Amiga's audio channels are used to
  188.      play  sampled  sounds  for the Bell and the BBS menu function 3 - Chat
  189.      call, so experiment and have some fun trying different sound samples.
  190.  
  191.      M A X's BBS has a built in FidoNet front  end,  message  importer  (or
  192.      tosser) and FidoNet dialer.  M A X's BBS can be easily configured as a
  193.      FidoNet Hub because of it's easy to use  "FidoNet  mail  distribution"
  194.      window.   Before M A X's BBS,  BBS programs relied on separate FidoNet
  195.      front end programs and message tosser programs to  set  up  a  FidoNet
  196.      system, making them slow and difficult to configure.
  197.  
  198.      M  A  X's  BBS has a custom print routine allowing speeds of over 9600
  199.      bps when printing/sending menus and  text.   The  BBS  program  called
  200.      "BBS-PC!"  could connect at 9600 bps but the text printing speed would
  201.  
  202.      Chapter 1                    M A X's BBS                       Page: 1
  203.  
  204.  
  205.  
  206.  
  207.      Chapter 1                    M A X's BBS                       Page: 2
  208.  
  209.      limit the sending of text to just over 2400 bps.   The faster speed is
  210.      achieved  by  printing  a line at a time then sending that line to the
  211.      serial port,  rather than a print character then send character method
  212.      (this will become noticeable when using speeds 1200 bps or less).
  213.  
  214.      M A X's BBS can be completely customized!   Not only can you make your
  215.      own menus but you can edit and change all the  BBS  text  and  colours
  216.      using the built in text editor.   You could even translate the English
  217.      text into another language.   You can insert the time, date or any one
  218.      of  the forty seven auto inserts anywhere in your text!   You can hide
  219.      all or parts of any text to users by  specifying  the  minimum  access
  220.      level.
  221.  
  222.      M  A  X's  BBS is a true ANSI BBS,  ie.  all the ANSI colour codes are
  223.      supported and any interruptions to the printing/sending of menus  (hot
  224.      keys)  and  text files will force an ANSI colour code (line 36) before
  225.      the text is printed/sent.  When the BBS sends a message such as "Press
  226.      <RETURN>  to  continue"  (line  29) or  warnings like "You have x mins
  227.      remaining..." (line 23) while printing a text file, the foreground and
  228.      background  colour  will  be  saved and restored before and after that
  229.      message.   This will stop any colour changes in text due to  that  BBS
  230.      message.
  231.  
  232.      M  A  X's  BBS  is  one  single  executable  file.   No messy separate
  233.      configuration or FidoNet programs to worry about,  it is all done with
  234.      the  one program!   A powerful online user editor lets the local Sysop
  235.      edit any part of the current online user,  including the user's name! 
  236.      A  message  optimizer will remove all unused space in the message base
  237.      files, this will save you precious disk space!
  238.  
  239.      M A X's BBS supports the following file transfer protocols:
  240.  
  241.                                 XModem
  242.                                 XModem CRC
  243.                                 XModem 1K
  244.                                 YModem (batch)
  245.                                 YModem-g
  246.                                 ZModem
  247.  
  248.      All protocols have been written as close to specification as possible.
  249.      The ZModem protocol is the latest revision available at  the  time  of
  250.      this release.
  251.  
  252.      M A X's BBS has been written in Assembler.  Not only does this make it
  253.      run faster but also makes the program  size  very  small  (about  173K
  254.      bytes).   Utilities and support programs are being written for M A X's
  255.      BBS and are available from the "M A X's BBS support files" section  on
  256.      my BBS (see "Reporting bugs and ordering") or from the Author.
  257.  
  258.  
  259.  
  260.      Chapter 1                    M A X's BBS                       Page: 2
  261.  
  262.  
  263.  
  264.  
  265.      Chapter 2                    M A X's BBS                       Page: 3
  266.  
  267.                                   INSTALLATION
  268.                                   ------------
  269.  
  270.      M A X's BBS comes on a standard AmigaDOS formatted disk.
  271.  
  272.              ***  MAKE A BACKUP NOW BEFORE YOU GO ANY FURTHER!  ***
  273.  
  274.      There  is  no  copy protection (please read the first paragraph if you
  275.      have not already), therefore any copy program will be adequate.
  276.  
  277.      M A X's BBS should run on a standard 512k byte Amiga  but  will  limit
  278.      the amount of multi-tasking you can do while the BBS is running in the
  279.      background.   Of course the more  memory  the  better.   The  optimize
  280.      message function is memory limited (see "Pull down menu functions").
  281.  
  282.      It  is possible to run the BBS as it is,  using only one floppy drive,
  283.      but the free space will limit the message base and  file  library  (if
  284.      any).   Therefore  it  is recommended that it be installed onto a hard
  285.      drive.  If you do not have a hard drive the BBS will run fine with two
  286.      floppy drives.   Use the first drive to hold the boot and main program
  287.      disk,  and use the second drive for the message base and file library.
  288.      Of  course  a practical file library would not be possible on a floppy
  289.      drive system but should be adequate for a good sized message base (see
  290.      "Configuring  the  BBS").   A  floppy disk cache program would also be
  291.      recommended to speed up the disk operations.
  292.  
  293.  
  294.      Hard drive installation:
  295.  
  296.      To  install  M A X's BBS onto a hard drive system make a new directory
  297.      on the hard drive called "BBS",  and then copy the BBS directory  from
  298.      the floppy disk to the hard drive BBS directory.
  299.  
  300.                     CLI eg:
  301.  
  302.                               MakeDir DH0:BBS
  303.                               Copy DF0:BBS/ DH0:BBS/
  304.  
  305.      M A X's BBS uses the font called "TBM.font".   If you do not have this
  306.      font  in  your  font  directory already,  then copy it from the floppy
  307.      disk's font directory to the hard drive's font directory.
  308.  
  309.                     CLI eg:
  310.  
  311.                               Copy DF0:Fonts/TBM.font DH0:Fonts/
  312.                               MakeDir DH0:Fonts/TBM
  313.                               Copy DF0:Fonts/TBM/8 DH0:Fonts/TBM/
  314.  
  315.      You must add to your "Startup-sequence" the AmigaDOS "Assign"  command
  316.      so that M A X's BBS will know where to find all the BBS files.
  317.  
  318.      Chapter 2                    M A X's BBS                       Page: 3
  319.  
  320.  
  321.  
  322.  
  323.      Chapter 2                    M A X's BBS                       Page: 4
  324.  
  325.                     CLI eg:
  326.  
  327.                               Assign BBS: DH0:BBS/
  328.  
  329.  
  330.      Starting the BBS:
  331.  
  332.      All data files are version dependent ie. you can not use early version
  333.      data files with a later version  program.   This  is  to  protect  the
  334.      system  from  crashing  due  to  differences  in  data  files as later
  335.      versions are released.   A conversion program called "MAXsCon" is sent
  336.      out  with all upgrades to convert your old data files to work with the
  337.      new version.   Any file zapping to the data files is done at your  own
  338.      risk.   M  A  X's  BBS  can be started either from WorkBench by double
  339.      clicking on the M A X's BBS icon, or from the "CLI".  To start M A X's
  340.      BBS  from  the  "CLI" use the AmigaDOS "Run" command so that the "CLI"
  341.      window can still be used after starting the program.
  342.  
  343.                     CLI eg:
  344.  
  345.                               Run BBS:MAXsBBS
  346.  
  347.      When  started,  M  A  X's  BBS  will  look  for  the  "MAXsBBS.config"
  348.      configuration data file in the "BBS:" file path.  If you wish to start
  349.      M A X's BBS with a different configuration file then you can  add  the
  350.      filename and path after the program name.
  351.  
  352.                     CLI eg:
  353.  
  354.                               Run BBS:MAXsBBS BBS:MAXsBBS.config
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.      Chapter 2                    M A X's BBS                       Page: 4
  377.  
  378.  
  379.  
  380.  
  381.      Chapter 3                    M A X's BBS                       Page: 5
  382.  
  383.                               CONFIGURING THE BBS
  384.                               -------------------
  385.  
  386.      Once the program is running, use the pull down menu called "Config" to
  387.      set up the BBS to suit your own needs.   Use the "Save all" and  "Load
  388.      all"  functions  to save all changes (including the BBS menus) on disk
  389.      and to restore any unwanted changes from disk.   The  following  is  a
  390.      description of each window and its associated gadgets:
  391.  
  392.  
  393.      System configure:
  394.  
  395.        This window has the file paths for all the BBS data files  and  text
  396.      files.   Change these as required,  and make sure the files are in the
  397.      right directory as indicated by the  file  path.   Change  the  system
  398.      parameters and flags to suit your disk space and needs.
  399.  
  400.        Text  files  file path:   This is the file path for all the BBS text
  401.      files.  It is also a good idea to put your own text files in this file
  402.      path  so  that they are all together,  and you will know where to look
  403.      when you need to edit them.  See the chapter "Customizing the BBS" for
  404.      a description of each of these files:
  405.  
  406.                                 BBS.text
  407.                                 Bulletin.text
  408.                                 FSEHelp.text
  409.                                 Guest.text
  410.                                 Intro.text
  411.                                 ListFilesHelp.text
  412.                                 ListFilesMenu.text
  413.                                 LockOut.text
  414.                                 LogIn.text
  415.                                 LogOut.text
  416.                                 MsgEdHelp.text
  417.                                 MsgEdMenu.text
  418.                                 MsgRdHelp.text
  419.                                 MsgRdMenu.text
  420.                                 MsgSearchMenu.text
  421.                                 ProtocolHelp.text
  422.                                 ProtocolList.text
  423.                                 ProtocolMenu.text
  424.  
  425.        User file path:  This is the file path for the user data file.   The
  426.      size  of  this file depends on the "Maximum users" value (see below). 
  427.      This is the filename of the user file:
  428.  
  429.                                 User.data
  430.  
  431.        Message files file path:  This is the file path for the message base
  432.      files.   The  size  of  these  files depends on the "Max" value in the
  433.  
  434.      Chapter 3                    M A X's BBS                       Page: 5
  435.  
  436.  
  437.  
  438.  
  439.      Chapter 3                    M A X's BBS                       Page: 6
  440.  
  441.      "Sections configure" window (see below),  ie.  the more messages there
  442.      are, the larger these files get.   The following files should be found
  443.      in this file path:
  444.  
  445.                                 Message.data
  446.                                 Message.index
  447.                                 Message.text
  448.  
  449.        Files file path #1:  This is the file path for the file library data
  450.      file  and  the  uploaded files themselves.   The size of the data file
  451.      depends on the "Max" value in the  "Sections  configure"  window  (see
  452.      below), but this would normally be insignificant compared to the space
  453.      required for the uploaded files.   Be sure that this file path  points
  454.      to  a disk with a lot of free space.   Also see "Minimum upload space"
  455.      below.  This is the filename of the file library data file:
  456.  
  457.                                 File.data
  458.  
  459.        Files file path #2 (opt):   This is a second optional file path  for
  460.      the  files  in  your  file  library.   Newly uploaded files are always
  461.      stored in the first file path (see above), but later they can be moved
  462.      to  one of the two optional file paths.   This is useful when you have
  463.      more than one hard drive or floppy disk and you  wish  to  spread  the
  464.      files between them.
  465.  
  466.        Files  file  path #3 (opt):   This is a third optional file path for
  467.      the files in your file library.  Same as above.
  468.  
  469.        Log files file path:   This is the file path for the caller log file
  470.      and the FidoNet log file.   The size of the caller log file depends on
  471.      the "Log size" value (see below).  The FidoNet log file is a text file
  472.      which contains the date and time for each FidoNet event.  It will also
  473.      log the name of the user and the "CLI" command used when using the BBS
  474.      menu  function 28 - CLI.   The FidoNet log file can be disabled in the
  475.      "FidoNet configure" window.   Each new entry to the FidoNet  log  file
  476.      will  be  appended to the file.   It can be read with any text editor,
  477.      text reading program or  typed  to  the  BBS  window  using  BBS  menu
  478.      function 13 - Type a file.  The FidoNet log file will continue to grow
  479.      in size until you delete it and start a new one or  disable  it.   The
  480.      filenames of the log files are:
  481.  
  482.                                 Log.data
  483.                                 Log.text
  484.  
  485.        Bell sample:   This is the bell sound sample's filename  and  path. 
  486.      This  is  the  sound  you will hear when the BBS sees the bell control
  487.      character (^G) in any text.  It is also used to attract your attention
  488.      in some parts of the BBS.
  489.  
  490.  
  491.  
  492.      Chapter 3                    M A X's BBS                       Page: 6
  493.  
  494.  
  495.  
  496.  
  497.      Chapter 3                    M A X's BBS                       Page: 7
  498.  
  499.        Play rate:  This is the play back rate of the bell sample.  The play
  500.      rate is in bytes per second and ranges from 500 to 28000.
  501.  
  502.        Chat  sample:   This  is the chat sound sample's filename and path. 
  503.      This is the sound you will hear when the BBS menu function  3  -  Chat
  504.      call,  is selected.   This is a fun one to play with,  limited only to
  505.      your sampled sound library.
  506.  
  507.        Play rate:  This is the play back rate of the chat sample.  The play
  508.      rate is in bytes per second and ranges from 500 to 28000.
  509.  
  510.        Max users:  This is the maximum number of users allowed on your BBS.
  511.      This is useful for limiting the user file size.   A user file  of  300
  512.      users  would  need  a user file of about 91K bytes.   If a new "Guest"
  513.      user tries to logon when the user file is full then  a  message  "User
  514.      file is full, call back next week" (line 8) will be given.  This gives
  515.      time for the Sysop to delete inactive users  and  make  room  for  new
  516.      "Guest"  users (see the pull down menu function "User editor").   This
  517.      value ranges from 1 to 65000.
  518.  
  519.        Max file size:   (Maximum file size)  This is the maximum file  size
  520.      that  can  be uploaded.   If a file exceeded this size it would not be
  521.      stored in the file library.   If the ZModem protocol is used to upload
  522.      a  file  which  exceeds  this  size,  then  the  file  will be skipped
  523.      ("ZSkip").   This is useful to stop users uploading files which  could
  524.      not be downloaded in the time limit available to most users.   This is
  525.      also useful when used in conjunction with the "Minimum  upload  space"
  526.      value  (see  below)  to prevent your upload disk from being completely
  527.      filled.  This value is in K (1024) bytes and ranges from 1 to 65000.
  528.  
  529.        Log size:   This is the caller log size.   A caller log size of  500
  530.      would need a log file size of about 35K bytes.  Also see the pull down
  531.      menu function "Caller log".  This value ranges from 1 to 99999.  Note:
  532.      Changing this value will restart the caller log.
  533.  
  534.        Upld  reward:   (Upload  reward)  This is used to encourage users to
  535.      upload files.   When a file is uploaded,  the  size  of  the  file  is
  536.      compared  to  this  value to calculate an increase for the user's time
  537.      limit,  as a reward for the upload.   This value is in seconds  per  K
  538.      (1024) bytes uploaded.   A value of zero (0) will never give an upload
  539.      reward.  Also see "Max time" below.  This value ranges from 0 to 120.
  540.  
  541.        Sleep time:   This sets the inactivity countdown timer used when the
  542.      BBS is waiting for a response from the user.  If this times out before
  543.      receiving a response from the user then the BBS will  hang-up  on  the
  544.      user (sleep disconnect).  The Bell will sound once for every minute of
  545.      inactivity to warn the user.  This value is in minutes and ranges from
  546.      1 to 59.
  547.  
  548.  
  549.  
  550.      Chapter 3                    M A X's BBS                       Page: 7
  551.  
  552.  
  553.  
  554.  
  555.      Chapter 3                    M A X's BBS                       Page: 8
  556.  
  557.        Countdown:  This is the value for the local countdown timer to force
  558.      a user off the BBS.  See the pull down menu function "Countdown" for a
  559.      description of the countdown timer.   This value  is  in  minutes  and
  560.      ranges from 1 to 59.
  561.  
  562.        Chat on:   This is the 24 hour time to turn on the BBS menu function
  563.      3 - Chat call.   This stops users from paging the  Sysop  at  unwanted
  564.      hours.   Note: Users with Sysop access (5000) can page the local Sysop
  565.      at any time.
  566.  
  567.        Chat off:   Same as above,  but is the 24 time to turn off the  chat
  568.      call function.   Note:  If this time is the same as the "Chat on" time
  569.      then the chat call function will always be on.
  570.  
  571.        Max pages:   (Maximum pages)  This is the maximum number of times  a
  572.      user  can  page  the Sysop for each login.   Exceeding this value will
  573.      give the "There's no point calling any more" (line 41) message.   This
  574.      stops  users  from  paging continuously.   This value ranges from 1 to
  575.      99999.
  576.  
  577.        U/D on:   (Upload/Download on)  This is similar to "Chat on" above. 
  578.      This  is  the  24  hour  time  that  users  can  start  selecting file
  579.      transfers.  This is useful to stop users tying up the BBS during prime
  580.      message hours.
  581.  
  582.        U/D  off:   (Upload/Download  off)   The  24  hour time to stop file
  583.      transfers.   Note:  If this time is the same as "U/D on"  (see  above)
  584.      then file transfers will be allowed at any time.
  585.  
  586.        Dimmer:  This is the timer value to dim the idle BBS screen.  If the
  587.      BBS has been waiting for the next caller for this time value, then the
  588.      screen  will  dim  to  help save your monitor's CRT.   The screen will
  589.      return to normal with any kind of activity (eg.  mouse  click).   This
  590.      value is in seconds and ranges from 1 to 99999 (never dims).
  591.  
  592.        Max time:   (Maximum time limit) This is the maximum time limit that
  593.      a user can obtain when receiving upload rewards (see above).   If  the
  594.      user  has  a  time  limit  the  same or higher than this value then no
  595.      upload rewards will be given.   This is to stop users from building up
  596.      a ridiculous time limit from upload rewards.  This value is in minutes
  597.      and ranges from 0 (no upload rewards) to 10000.
  598.  
  599.        Min up spc:   (Minimum upload space)   This  is  the  minimum  space
  600.      allowed  on  the  disk  pointed  to  by  the "Files file path #1" (see
  601.      above).   This is useful to prevent the upload disk from  getting  too
  602.      full  and  thus  preventing  messages from being saved (only if on the
  603.      same disk).  If the "Minimum upload space" is exceeded, then a message
  604.      "Getting  low  on  upload  space" (line 194) will be given when a user
  605.      tries to upload a file.  When uploading using the ZModem protocol, the
  606.      file  size  is checked against the "Minimum upload space" and the file
  607.  
  608.      Chapter 3                    M A X's BBS                       Page: 8
  609.  
  610.  
  611.  
  612.  
  613.      Chapter 3                    M A X's BBS                       Page: 9
  614.  
  615.      is skipped ("ZSkip") if it exceeds this  value.   Use  this  value  in
  616.      conjunction  with  the  "Maximum  file  size" ie.  "Maximum file size"
  617.      should be smaller than "Minimum upload space".   This value  is  in  K
  618.      (1024) bytes and ranges from 1 to 99999.
  619.  
  620.        Max  tm  bnk:   (Maximum  time  bank)  This is the maximum time bank
  621.      balance a user can obtain when depositing to the time  bank.   If  the
  622.      user  has  a  time  bank balance the same or higher,  then the message
  623.      "Your time bank balance is too high!" (line 240) will  be  given  when
  624.      attempting  to  deposit more time.   See BBS menu functions 29 to 31. 
  625.      This value is in minutes and ranges from 0 (no deposits) to 10000.
  626.  
  627.        New files public:   This gadget is used to select whether or  not  a
  628.      newly uploaded file will be available to all users.   Note: Users with
  629.      Sysop access (5000) can access any "New" file.
  630.  
  631.        Esc ctrl chars:   (Escape control characters)  Used with the  ZModem
  632.      file  transfer protocol only.   The ZModem protocol allows encoding of
  633.      all control characters for  non-transparent  data  path  mediums  (eg.
  634.      networks).   Selecting  this  will  force all control characters to be
  635.      escaped.   Note:  This will greatly increase file transfer times,  use
  636.      only if needed.   This may not work with some early implementations of
  637.      the ZModem protocol.
  638.  
  639.        Flashing text:   Select this to enable  ANSI  flashing  or  blinking
  640.      text.  This will open a four bit plane screen to enable flashing text.
  641.      Note:  When turned on,  it will slow down the Amiga's "Intuition"  and
  642.      font routines giving a slower scroll and print.
  643.  
  644.        NTSC  (Interlace):   Select  this  if  you are using an NTSC display
  645.      system (USA).  Interlace mode is used for NTSC to gain the extra lines
  646.      required  by  the  PAL system that this program was originally written
  647.      for.   Sorry,  but it is easy going from NTSC to PAL but  not  PAL  to
  648.      NTSC.   It  will  also  change  the  timing routines as PAL is a 50 Hz
  649.      system and NTSC is a 60 Hz system.
  650.  
  651.        ZModem XON/XOFF:   Select this to turn on XON/XOFF flow control  for
  652.      rates  of  2400 bps and below during a ZModem receive.   This does not
  653.      effect ZModem send.   XON/XOFF flow control is default  on  for  rates
  654.      higher  than 2400 bps.   This would normally be turned off as for most
  655.      cases the Amiga can keep up with rates 2400 bps and below,  but if you
  656.      are doing heavy multi-tasking during ZModem receives then turn on this
  657.      gadget.   This option was added to help stop stray XOFF's from locking
  658.      up  the  BBS  during ZModem receives.   Rates higher than 2400 bps are
  659.      normally protected  with  MNP  (Microcom  Networking  Protocol)  error
  660.      correction.   Note:  ZModem send handles all XON/XOFF flow control, if
  661.      an XOFF is not followed by an XON in 60 seconds then the file transfer
  662.      will abort.
  663.  
  664.  
  665.  
  666.      Chapter 3                    M A X's BBS                       Page: 9
  667.  
  668.  
  669.  
  670.  
  671.      Chapter 3                    M A X's BBS                      Page: 10
  672.  
  673.      Modem configure:
  674.  
  675.      This window contains the information and options about the  modem  you
  676.      wish  to  use  with the BBS.   The default setup should work with most
  677.      standard 2400 bps "AT" command set modems.   The BBS assumes that  all
  678.      serial data is 8 data bits, 1 stop bit and no parity.  7 data bits was
  679.      considered, but would not be compatible with the current file transfer
  680.      protocols.   The  BBS  will  hang-up  the  modem by dropping the "Data
  681.      Terminal Ready" (DTR) signal,  so be sure to tell your modem  this  in
  682.      the  "Setup"  command string (see below).   The term "bits per second"
  683.      (bps) is used instead of baud rate because by definition baud rate  is
  684.      the  rate  of  change in the signal.   With the high speed modems used
  685.      today,  a change in the signal could mean a two or more bit change  in
  686.      data.   Therefore  the  baud  rate  may  be the same or lower than the
  687.      actual bits per second.  All the string gadgets in this window can use
  688.      the control character specifier "^".  The "^" character means that the
  689.      following character is a control character.  See the "Text editor" for
  690.      more  information  on  using  the  control  character specifier.   The
  691.      following are descriptions of the gadgets in this window:
  692.  
  693.        Max:   (Maximum bps)  This is the maximum bps rate that  your  modem
  694.      can connect at, or the bps rate that the BBS will use when "Locked bps
  695.      rate" (see below) is selected.   This is the bps rate at which the BBS
  696.      will  send the "Setup" command string (see below) to the modem.   Some
  697.      modems will connect at a bps rate the same or lower than the bps  rate
  698.      that the last command was sent.  Therefore when a user connects at 300
  699.      bps, at the end of the session the BBS will resend the "Setup" command
  700.      string to the modem at this maximum bps rate,  allowing other users to
  701.      connect at a higher bps rate.  This parameter ranges from 300 to 19200
  702.      and is in bps (the rate doubles for each step).
  703.  
  704.        Min:   (Minimum bps)  This is similar to the above except that it is
  705.      the lowest bps rate that you will allow users to connect to your  BBS.
  706.      If  a  user  connects at a lower bps rate than this minimum,  then the
  707.      "Too slow connection" (line 131) message will be  given  and  the  BBS
  708.      will  then  hang-up  (or  after  a  new "Guest" user has been sent the
  709.      "Guest.text" file).  This is useful to stop 300 bps callers from tying
  710.      up  the  BBS.   Again this is in bps and ranges from 300 to 19200 (the
  711.      rate doubles for each step).
  712.  
  713.        Setup:   This is the modem command string  used  to  initialize  the
  714.      modem at start-up and after each call.  Use this command string to put
  715.      your modem into auto answer.   Do not  forget  to  add  the  "Carriage
  716.      Return"  (^M)  at  the  end.   It  is  also  recommended to change the
  717.      attention character register to 1 to prevent users  from  accidentally
  718.      putting  your  modem  into command mode when the BBS echoes characters
  719.      back to the user.   This was an old way "Hackers" used to crash BBS's,
  720.      but do not worry, if your modem does go into command mode the BBS will
  721.      time out (sleep disconnect),  hang-up and resend the "Setup"  string. 
  722.      The  character  "~"  can  be  used  to force a one second delay before
  723.  
  724.      Chapter 3                    M A X's BBS                      Page: 10
  725.  
  726.  
  727.  
  728.  
  729.      Chapter 3                    M A X's BBS                      Page: 11
  730.  
  731.      sending the next characters.   Here is an example command string which
  732.      first  resets  the  modem,  tells  the modem to hang-up when the "DTR"
  733.      signal is dropped,  redefines the attention character to 1 and set the
  734.      number of rings to answer for two:
  735.  
  736.                               ATZ^M~AT&D2S2=1S0=2^M
  737.  
  738.        300:   This is the string that the modem sends to the BBS when a 300
  739.      bps connection is established.  When the BBS sees the "Carrier Detect"
  740.      (CD)  signal  active  it  will  wait  for the connection string,  then
  741.      optionally change to the bps rate indicated by the  connection  string
  742.      (also  see  "Locked bps rate" below).   The strings are case sensitive
  743.      and a "Carriage Return"  (^M)  and  "Line  Feed"  (^J)  will  normally
  744.      terminate the strings.  Note: A common problem of the BBS appearing to
  745.      lock-up when a carrier is detected is because the connect string  that
  746.      the  modem  sends  to the BBS,  does not match with any of the connect
  747.      strings defined here and below.
  748.  
  749.        600:   This is the string that the modem sends to the BBS when a 600
  750.      bps connection is established.  Rarely used now.
  751.  
  752.        1200:   This  is  the  string that the modem sends to the BBS when a
  753.      1200 bps connection is established.
  754.  
  755.        2400:   This is the string that the modem sends to the  BBS  when  a
  756.      2400 bps connection is established.
  757.  
  758.        4800:   This  is  the  string that the modem sends to the BBS when a
  759.      4800 bps connection is established.
  760.  
  761.        9600:   This is (yes you guessed it) the string that the modem sends
  762.      to the BBS when a 9600 bps connection is established.
  763.  
  764.        19200:   This  is  the string that the modem sends to the BBS when a
  765.      19200 bps connection is established.
  766.  
  767.        Busy:   This is the string that the modem sends to the  BBS  when  a
  768.      busy signal is detected.  Used in the "FidoNet dialer".
  769.  
  770.        No  DT:   (No Dial Tone)  This is the string that the modem sends to
  771.      the BBS when no dial tone is detected.  Used in the "FidoNet dialer".
  772.  
  773.        Seven-wire handshaking:   This gadget is used to  select  seven-wire
  774.      (CTS/RTS)  handshaking between the BBS and the modem.   This option is
  775.      normally used for high speed buffered modems.   Use it in  conjunction
  776.      with  "Lock  bps  rate" (see below) and a maximum bps rate higher than
  777.      the maximum rate your modem will connect at,  to increase the  through
  778.      put for MNP (Microcom Networking Protocol) modems.   When using seven-
  779.      wire handshaking you may experience delays when  the  modem's  buffers
  780.      are  full,  this  is  because while the modem empties it's buffers the
  781.  
  782.      Chapter 3                    M A X's BBS                      Page: 11
  783.  
  784.  
  785.  
  786.  
  787.      Chapter 3                    M A X's BBS                      Page: 12
  788.  
  789.      handshaking stops the sending of any more  data  by  the  BBS.   Note:
  790.      Because  of a problem (bug?) with the Amiga's "serial.device",  seven-
  791.      wire handshaking only works when the modem  signal  "Data  Set  Ready"
  792.      (DSR) is active.   If seven-wire handshaking is not working, try using
  793.      the command "AT&S0" to force the modem's "DSR" signal active.
  794.  
  795.        Locked bps rate:   This gadget is use to select a  locked  bps  rate
  796.      between the modem and the BBS.  When selected, the BBS will not change
  797.      the bps rate when a connect string from  the  modem  is  received.   A
  798.      locked  bps  rate  is  normally  used with seven-wire handshaking (see
  799.      above).
  800.  
  801.        Send setup string twice:   When this gadget is turned  on,  the  BBS
  802.      will always send the "Setup" command string twice to the modem.   Some
  803.      modems may not auto change the bps rate to the BBS  bps  rate  on  the
  804.      first  command  string,  and therefore miss the command string.   This
  805.      gadget guarantees that the modem will change it's bps rate and receive
  806.      the command string.
  807.  
  808.        Slow  command string:   This gadget is used to select the sending of
  809.      the "Setup" command string at a slow typing speed.   Some  modems  may
  810.      not like command strings being sent at full speed,  and will miss some
  811.      or all characters in the string.
  812.  
  813.        Serial unit #:  This gadget contains the serial unit number that the
  814.      BBS  will  use.   For  those  with  more  than one serial port.   On a
  815.      standard Amiga this is set to unit zero (0).
  816.  
  817.        Snd setup:   (Send setup)  Click on this gadget to send the  "Setup"
  818.      command string to the modem.
  819.  
  820.  
  821.      Menu editor:
  822.  
  823.      This is a very powerful window.   It is where you define the keys  and
  824.      functions  of  all  the  BBS  menus.   See  the  chapter  on "BBS menu
  825.      functions" for a list and description of the currently available  menu
  826.      functions.   Also  see "Customizing the BBS".   You must have at least
  827.      one menu.   All the BBS menu data is stored  in  the  "MAXsBBS.config"
  828.      file,  this  file will grow as you add more menus to your BBS.   It is
  829.      recommended to print out the menu functions summary file called:
  830.  
  831.                                 MenuFunctions.text
  832.  
  833.      Have this with you as a  quick  look-up  for  all  the  menu  function
  834.      numbers.  Each menu is numbered and may be as large as memory permits.
  835.      This window can display up to ten menu  functions.   If  the  menu  is
  836.      larger,  then  it  will  continue in the next lot of ten (use the down
  837.      arrow).  The following are descriptions of the gadgets in this window:
  838.  
  839.  
  840.      Chapter 3                    M A X's BBS                      Page: 12
  841.  
  842.  
  843.  
  844.  
  845.      Chapter 3                    M A X's BBS                      Page: 13
  846.  
  847.        Up and down arrows:   Use these gadgets to move up and down in  lots
  848.      of  ten.   If  a menu is smaller than ten functions then the next menu
  849.      will be shown.
  850.  
  851.        Goto:   This is a "go to menu number" gadget.   To use  this  simply
  852.      click in the box,  type the number of the menu you wish to go to, then
  853.      press <Return>.
  854.  
  855.        Text filename:   This is the filename and path of the menu text file
  856.      associated with the current menu number.   This menu text file is what
  857.      is seen by the user.   When you enter a filename here the menu  number
  858.      will  automatically  increase  by  one  if this is the last menu,  ie.
  859.      adding a new menu.  Note:   If you insert a menu and enter a filename,
  860.      it  will  have  no  effect unless you are at the last menu.   The same
  861.      applies for menus which are larger than one full window (ten entries).
  862.  
  863.        Key:   This is the key or character  (always  UPPER  case)  used  to
  864.      select the menu function.  The BBS scans this field from top to bottom
  865.      and if a match is found then the access is checked.   If the user does
  866.      not have access to this function, then it will continue scanning until
  867.      it either finds the end of this menu, or it finds a match and the user
  868.      has access.   This is useful in that you can have the same key perform
  869.      different functions depending on the user's access level.
  870.  
  871.        Function:   This is the number of the function to perform  with  the
  872.      associated key (see above).  This value ranges from 0 (not defined) to
  873.      33.  See "BBS menu functions".
  874.  
  875.        Extra:   This is an extra parameter to use with  the  function  (see
  876.      "BBS  menu  functions").   Note:  Not all BBS menu functions need this
  877.      field and it may therefore have no effect.   This value ranges from  0
  878.      to 10000.
  879.  
  880.        Access:   This  is  the  access level needed by the user to use this
  881.      function.  The user must have the same or higher access level.  If the
  882.      user  has  an access level less than this value,  then the key pressed
  883.      will be ignored and no message will be seen by the user.   This  stops
  884.      users  from  randomly pressing keys to see what might be hidden in the
  885.      menu.   The BBS will continue scanning for another match if  the  user
  886.      does not have high enough access (see "Key" above).  This value ranges
  887.      from 0 to 10000.
  888.  
  889.        Filename/Name/Dest:  This is additional text that may be required by
  890.      the  function.   For  example a filename is required with the BBS menu
  891.      function 13 - Type a file.  Note: Not all BBS menu functions need this
  892.      field and it may therefore have no effect.
  893.  
  894.        Top/Btm:   (Top/Bottom)   Click  on this gadget to move to the first
  895.      and last menu.   Use this gadget first to move to the last menu before
  896.      you try to add a new menu.
  897.  
  898.      Chapter 3                    M A X's BBS                      Page: 13
  899.  
  900.  
  901.  
  902.  
  903.      Chapter 3                    M A X's BBS                      Page: 14
  904.  
  905.        Show:   Click on this gadget to show the  menu  text  file  for  the
  906.      current  menu  number.   This  is  useful if you forget which keys are
  907.      supposed to select which function.   It also lets  you  check  if  the
  908.      filename  and  path  are correct.   Click again or hit any key to exit
  909.      back to the menu editor.
  910.  
  911.        Add/Insert:   Click on this gadget to add a new menu,  or to  insert
  912.      more  functions to an existing menu.   The insert will be placed after
  913.      the current menu.
  914.  
  915.        Delete:  Click on this gadget to delete the current menu.  All menus
  916.      after the deleted menu (if any) will be moved up.   You can not delete
  917.      the first menu.   Note:  If you delete a menu which is larger than ten
  918.      functions,  be  sure  to add the filename and path of the text file to
  919.      the remaining part of the menu.  Also if you delete a menu completely,
  920.      the menu numbers of the remaining menus will not change,  ie.  you may
  921.      have menu numbers missing.
  922.  
  923.  
  924.      Sections configure:
  925.  
  926.      M A X's BBS,  like many BBS's,  uses sections to divide up the message
  927.      base and file library.   The sections help to organize and  categorize
  928.      large message bases and file libraries.  All functions associated with
  929.      the message base and file library require a section number.   You  can
  930.      have  up  to  100 sections.   Note:  Section 0 is reserved for private
  931.      messages.   Messages in this section will require the  message  to  be
  932.      "To"  or "From" the user to be read (Sysops (access 5000) can read all
  933.      private messages).
  934.  
  935.      The addition  of  flags  for  each  section  makes  each  section  act
  936.      differently.  M A X's BBS has a unique maximum value for each section,
  937.      allowing a different maximum number  of  messages  or  files  in  each
  938.      section!   When  a  section  becomes full it will roll ie.  the oldest
  939.      message or file will be deleted to make room for the new one.  This is
  940.      how  the  size of the section can be controlled for file size reasons,
  941.      as well as management reasons.   Messages and files can be roll locked
  942.      (by a Sysop) to prevent it from being deleted when the section becomes
  943.      full.  It will instead delete the next unlocked message or file.   The
  944.      following are descriptions of the gadgets in this window:
  945.  
  946.        Up  and down arrows:   Use these gadgets to move up and down in lots
  947.      of ten.
  948.  
  949.        Name:  This is where you enter the name of the section.  The name of
  950.      the  section is displayed along with the message when it is being read
  951.      (see BBS menu function 17 - Read messages).
  952.  
  953.        Access:   This is the access level required by the  user  to  access
  954.      messages  or files in this section.   If the access is zero (0),  then
  955.  
  956.      Chapter 3                    M A X's BBS                      Page: 14
  957.  
  958.  
  959.  
  960.  
  961.      Chapter 3                    M A X's BBS                      Page: 15
  962.  
  963.      the section is not valid and is not used by the BBS.  Note: When using
  964.      "linked sections" (sections 100,  101 and 102) the user still needs an
  965.      access level the same or higher to include that section as one of  the
  966.      linked sections.  This value ranges from 0 (not used) to 10000.
  967.  
  968.        Max:   (Maximum  messages/files)   This  is  the  maximum  number of
  969.      messages or files allowed in this section.   When  a  section  becomes
  970.      full  it  will  automatically  delete  the oldest message or file (see
  971.      above).  This value ranges from 1 to 99999.
  972.  
  973.        Frm:  (From flag)  This flag specifies whether or not a user can see
  974.      who  the  message  or  file  is  from.   This  is useful for anonymous
  975.      sections.   Note:  When searching messages (see BBS menu function 17 -
  976.      Read  messages),  this  flag  must  be  set for the search function to
  977.      include this section's "From" field in the search.  This was added for
  978.      security reasons.
  979.  
  980.        To:   This  flag  specifies  whether  or  not a user can see who the
  981.      message is to.  This is useful for anonymous message sections.   Note:
  982.      When  searching  messages  (see BBS menu function 17 - Read messages),
  983.      this flag must  be  set  for  the  search  function  to  include  this
  984.      section's "To" field in the search.
  985.  
  986.        Del:   (Delete  flag)  This flag specifies whether or not a user can
  987.      delete a message "To" or "From" them,  or a file  uploaded  by  them. 
  988.      Note: Sysops (access 5000) can delete any message or file.
  989.  
  990.        Lnk:  (Linked section flag)  This flag specifies whether or not this
  991.      section is included as a linked section.   Sections 100,  101 and  102
  992.      are  used  to specify linked sections.   Section 100 means include all
  993.      linked local messages or files.   Section 101 means include all linked
  994.      echo messages.   Sections 102 means include both linked local and echo
  995.      messages.   For example, a "Read all new local mail" menu choice would
  996.      use  linked  section 100 as the section number (limited to user access
  997.      level).
  998.  
  999.        Als:   (Alias flag)  This flags specifies whether or not a user  can
  1000.      type  in an alias to use as the author's name.   It can be quite funny
  1001.      reading a message from "Batman"!   Replies to messages left  using  an
  1002.      alias, will be found on the logon mail search as addressed to the user
  1003.      who used the alias.   Note:  Sysops (access 5000) will see the  user's
  1004.      real name next to the alias when reading messages.   Same applies when
  1005.      listing files from an alias.
  1006.  
  1007.        Fil:   (File flag)  This flag  is  the  difference  between  a  file
  1008.      section  and  a message section.   Note:  You can not mix messages and
  1009.      files in the same section,  and only linked section number 100 can  be
  1010.      used with file BBS menu functions.
  1011.  
  1012.  
  1013.  
  1014.      Chapter 3                    M A X's BBS                      Page: 15
  1015.  
  1016.  
  1017.  
  1018.  
  1019.      Chapter 3                    M A X's BBS                      Page: 16
  1020.  
  1021.        Ech:   (Echo mail flag)  This flag specifies a FidoNet echo  message
  1022.      section.   This  flag  must be set to use this section in the "FidoNet
  1023.      mail distribution" window.
  1024.  
  1025.        Top/Btm gadget:   (Top/Bottom)  Click on this gadget to move to  the
  1026.      first ten and last ten sections.
  1027.  
  1028.  
  1029.      User defaults:
  1030.  
  1031.      This window is  used  to  set  the  user  defaults  for  "Guests"  and
  1032.      "Members".   A "Guest" user is one who is new to your BBS.   The Guest
  1033.      user will remain a Guest until a Sysop upgrades their access (see  the
  1034.      pull  down  menu  function - "User editor").   The Member defaults are
  1035.      used for instant Member's status in all three different  user  editors
  1036.      (see  the  pull down menu function "User editor" and BBS menu function
  1037.      26 - Edit a user).   The following is a description of the gadgets  in
  1038.      the "User defaults" window:
  1039.  
  1040.        Rd:   (Read  access  flag)   This  is  the  read  access  flag which
  1041.      specifies whether or not a user can read messages (regardless of their
  1042.      access level).
  1043.  
  1044.        Wr:   (Write  access  flag)   This  is  the  write access flag which
  1045.      specifies whether  or  not  a  user  can  write  or  leave  a  message
  1046.      (regardless of their access level).
  1047.  
  1048.        Up:   (Upload  access  flag)   This  is the upload access flag which
  1049.      specifies whether or not a user can upload files (regardless of  their
  1050.      access level).
  1051.  
  1052.        Dn:   (Download access flag)  This is the download access flag which
  1053.      specifies whether or not a user  can  download  files  (regardless  of
  1054.      their access level).
  1055.  
  1056.        Access  level:   This  is the access level of the user.   The access
  1057.      level must be the same or higher than the access level  in  the  "Menu
  1058.      editor" window, or the "Sections configure" window for the user to use
  1059.      that function or section.   The access level can also be used to  hide
  1060.      parts  or all of text (see "Customizing the BBS").   This value ranges
  1061.      from 0 (locked out) to 10000 (Almighty Sysop access!).
  1062.  
  1063.        Time limit:  This is the daily online time limit for the user.  Once
  1064.      a  user has logged on the BBS,  the timer is started,  when it reaches
  1065.      zero the BBS will give the message "Out of time" (line 24)  and  hang-
  1066.      up.   When the time remaining reaches five minutes or less,  a warning
  1067.      message will be given for every minute (line 23).  Once the daily time
  1068.      limit has been exceeded, the user will have to wait until the next day
  1069.      to refresh the time remaining.   This value ranges from 0 to 10000 and
  1070.      is in minutes.
  1071.  
  1072.      Chapter 3                    M A X's BBS                      Page: 16
  1073.  
  1074.  
  1075.  
  1076.  
  1077.      Chapter 3                    M A X's BBS                      Page: 17
  1078.  
  1079.        D/U Ratio:   (Download/Upload Ratio)   This  is  a  download  versus
  1080.      upload  ratio  used  to  help  prevent users downloading files and not
  1081.      contributing any uploads (file hogs).   A value of zero  (0)  disables
  1082.      this  check.   Maximum  of 10000 and is in actual number of successful
  1083.      files transferred.
  1084.  
  1085.  
  1086.      Text editor:
  1087.  
  1088.      M  A X's BBS lets you completely customize the look of your BBS.   The
  1089.      text editor lets you edit all the BBS text.   You can change the  ANSI
  1090.      colour  codes  or even change the BBS to a different language!   It is
  1091.      recommended that you get used to the BBS before you try to change  the
  1092.      actual  text.   You can replace any text you like to suit the theme or
  1093.      name you choose to give your BBS (see "Customizing the  BBS").   Note:
  1094.      Changing  the  text  too  much  may confuse a new user or a user first
  1095.      starting out.  It is up to you as a Sysop to help such users, remember
  1096.      when  you got your first modem!   The last few empty text lines can be
  1097.      used with the BBS menu function 15 - Print text.   Be sure only to use
  1098.      lines from the last line upwards, as future upgrades will use the next
  1099.      blank line and downwards and therefore will overwrite your text.
  1100.  
  1101.      To insert control characters into the text you must  use  the  control
  1102.      character specifier "^", followed by the ASCII character calculated by
  1103.      adding 64 (Hex 40) to the control character's ASCII value.   Here is a
  1104.      list of control characters you can use and their equivalent:
  1105.  
  1106.  
  1107.              Name:                       ASCII value:     Equivalent:
  1108.  
  1109.              Bell                        7                ^G
  1110.              Backspace                   8                ^H
  1111.              Tab                         9                ^I
  1112.              Line Feed                   10               ^J
  1113.              Form Feed (Clears screen)   12               ^L
  1114.              Carriage Return             13               ^M
  1115.              Escape                      27               ^[
  1116.  
  1117.  
  1118.        Some  text  lines  may  not  be that obvious when and where they are
  1119.      used, so here is a list of the less obvious lines:
  1120.  
  1121.          0:  The Sysop's name, place your name here!
  1122.  
  1123.         36:   The ANSI code printed/sent to reset any colours when  a  menu
  1124.      "Hot key" is pressed.
  1125.  
  1126.         43:  The ANSI code to set the colour of the characters typed by the
  1127.      local Sysop when chatting to a user.
  1128.  
  1129.  
  1130.      Chapter 3                    M A X's BBS                      Page: 17
  1131.  
  1132.  
  1133.  
  1134.  
  1135.      Chapter 3                    M A X's BBS                      Page: 18
  1136.  
  1137.         44:  The ANSI code to set the colour of the characters typed by the
  1138.      user when chatting to the local Sysop.
  1139.  
  1140.         58:   The  ANSI  code  to  set the colour of the line number in the
  1141.      normal message text editor.
  1142.  
  1143.         59:   The ANSI code to set the colour of the text  after  the  line
  1144.      number in the normal message text editor.
  1145.  
  1146.         91:   The  ANSI  code  to  set  the colour of the message text when
  1147.      reading messages.
  1148.  
  1149.        115:  The "quoted" text prefix used when quoting text from a message
  1150.      you are replying to.
  1151.  
  1152.        127:   The  ANSI  code  to  set  the  colour of the user's name when
  1153.      listing users.
  1154.  
  1155.        128:   The ANSI code to set the colour of  the  user's  suburb  when
  1156.      listing users.
  1157.  
  1158.        129:   The  ANSI  code  to set the colour of the user's last on date
  1159.      when listing users.
  1160.  
  1161.        143:   Used to terminate the printing of the caller log  when  using
  1162.      BBS menu function 19 - Print caller log.
  1163.  
  1164.        150:   The  ANSI code to set the colour of the filename when listing
  1165.      files.
  1166.  
  1167.        151:   The ANSI code to set the colour of the file size when listing
  1168.      files.
  1169.  
  1170.        152:   The  ANSI  code  to  set the colour of the date uploaded when
  1171.      listing files.
  1172.  
  1173.        153:   The ANSI code to set the colour of whom a file is  from  when
  1174.      listing files.
  1175.  
  1176.        154:   The  ANSI code to set the colour of the file description when
  1177.      listing files.
  1178.  
  1179.        155:  The text after the filename to show that the file is locked.
  1180.  
  1181.        156:  The text after the filename to show that the file is "New".
  1182.  
  1183.        182:   The text printed after line  181  on  completion  of  a  file
  1184.      transfer.
  1185.  
  1186.  
  1187.  
  1188.      Chapter 3                    M A X's BBS                      Page: 18
  1189.  
  1190.  
  1191.  
  1192.  
  1193.      Chapter 3                    M A X's BBS                      Page: 19
  1194.  
  1195.        197:   The ANSI code to set the colour of the text  when  reading  a
  1196.      text file from the file library.
  1197.  
  1198.        198:  The text used to terminate the reading of a text file from the
  1199.      file library.
  1200.  
  1201.        234:   The  text  before  the  output  file  of  a  CLI  command  is
  1202.      printed/sent.
  1203.  
  1204.        254:   The  prefix text used when printing the user's real name next
  1205.      to the user's alias while reading messages (Sysop access only).
  1206.  
  1207.        255:   The suffix text used when printing the user's real name  next
  1208.      to the user's alias while reading messages (Sysop access only).
  1209.  
  1210.        258:   The  prefix text used when printing the user's real name next
  1211.      to the user's alias while listing files (Sysop access only).
  1212.  
  1213.        259:   The suffix text used when printing the user's real name  next
  1214.      to the user's alias while listing files (Sysop access only).
  1215.  
  1216.  
  1217.      Macros:
  1218.  
  1219.      M A X's BBS has built in local Sysop  macros!   Macros  allow  you  to
  1220.      define  the  Amiga's  function keys to automatically type text strings
  1221.      into messages or anywhere that requires input from the keyboard.  They
  1222.      can  be  used  when you find that you are continuously typing the same
  1223.      thing over and over.   Macros are useful for making nice sign-offs  at
  1224.      the end of your messages, or entering your name at logon.  The "Shift"
  1225.      gadget will toggle the window between the normal function keys and the
  1226.      shifted function keys.  This gives you two strings per function key.
  1227.  
  1228.  
  1229.      FidoNet configure:
  1230.  
  1231.      FidoNet is a system where many BBS's can share the same message  base.
  1232.      When  a  new message is stored in an echo message section,  it is also
  1233.      stored in one or more of the OutBound FidoNet files according  to  the
  1234.      destinations  specified in the "FidoNet mail distribution" window (see
  1235.      below).   These OutBound FidoNet message files  are  called  bundles. 
  1236.      Message  bundles  can  also  be  optionally archived using the utility
  1237.      called "Lharc",  a program written by Paolo Zibetti and  available  on
  1238.      most  good Amiga BBS's.   "Lharc" version 1.30 was tested with M A X's
  1239.      BBS but versions the same or higher should work.  A FidoNet system can
  1240.      either  then call your BBS to pick up their files,  or your BBS can be
  1241.      configured to call their BBS.   Once a FidoNet connection session  has
  1242.      been  started,  files  are  first sent to the answering BBS,  then the
  1243.      OutBound files for the originating BBS (if  any)  are  sent.   Message
  1244.      bundles can be empty ie.  no messages.  These empty bundles are called
  1245.  
  1246.      Chapter 3                    M A X's BBS                      Page: 19
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Chapter 3                    M A X's BBS                      Page: 20
  1252.  
  1253.      "Poll" packets,  and are used to "Poll" the answering system in  order
  1254.      to  pick  up  the  waiting  OutBound files.   Once all files have been
  1255.      transferred,  the built in message importer will examine  the  InBound
  1256.      files  file  path  for  message  bundles  to  process  (see "Force msg
  1257.      import").
  1258.  
  1259.      A "Hub" is a  FidoNet  system  configured  as  the  central  answering
  1260.      system.   All  members  of  a "Net" would join the network in a "Star"
  1261.      fashion ie. they all call the same Hub (see "BBS address" below).
  1262.  
  1263.  
  1264.                                      (BBS)
  1265.                                        |
  1266.                                 (BBS)  |  (BBS)
  1267.                                    \   |   /
  1268.                                     \  |  /
  1269.  
  1270.                            (BBS)---- (Hub) ----(BBS)
  1271.  
  1272.                                     /  |  \
  1273.                                    /   |   \
  1274.                                 (BBS)  |  (BBS)
  1275.                                        |
  1276.                                      (BBS)
  1277.  
  1278.  
  1279.      A Hub can also call another Hub,  which would then link the  two  Nets
  1280.      together.   This  is  basically  how  a  message  base  can  be shared
  1281.      internationally.   There is no limit to how many BBS's  can  join  the
  1282.      network.   All  OutBound  FidoNet  files  use four dimension filenames
  1283.      created from the destination address.   The following are descriptions
  1284.      of the gadgets found in this window:
  1285.  
  1286.        OutBound  files  file  path:   This  is the OutBound files file path
  1287.      where all OutBound files are stored.   OutBound files  can  either  be
  1288.      picked  up  by  the  destination or the destination can be called (see
  1289.      "Phone numbers" below).
  1290.  
  1291.        InBound files file path:   This is the InBound files file path where
  1292.      all  InBound  files are stored.   InBound files are processed straight
  1293.      away by the "Message importer" (see "Force msg import").
  1294.  
  1295.        "* Origin":  This is the text that will appear in the origin line at
  1296.      the  bottom of every message originating from your BBS.   Normally you
  1297.      would put a comment here advertising  your  BBS.   Do  not  forget  to
  1298.      include your BBS phone number!
  1299.  
  1300.        BBS   address:    This   is   YOUR   BBS   address   in   the   form
  1301.      Zone:Net/Node.Point.   When you join a "Net" your network co-ordinator
  1302.  
  1303.  
  1304.      Chapter 3                    M A X's BBS                      Page: 20
  1305.  
  1306.  
  1307.  
  1308.  
  1309.      Chapter 3                    M A X's BBS                      Page: 21
  1310.  
  1311.      will allocate you with an address.   You must enter that address here.
  1312.      Here is an example address:
  1313.  
  1314.                                 3:712/306.1
  1315.  
  1316.      Where  the  Zone  is "3" (Australia).   The Net is "712";  this is the
  1317.      "Net" that you belong to.   The Node is "306";  this is unique to your
  1318.      BBS  unless "Pointing" from another BBS.   The Point is "1";  your BBS
  1319.      address would normally have zero (0) for the  point  unless  you  have
  1320.      joined the "Net" through another BBS not a Hub.
  1321.  
  1322.        Sysop:   This is the name of the Sysop, enter your name here!   This
  1323.      is the name that will be logged when FidoNet sessions take place.
  1324.  
  1325.        Phone numbers:   Your BBS can be configured to dial another  FidoNet
  1326.      system (Hub) at any time.  This gadget contains the modem commands and
  1327.      phone number that are sent  to  the  modem  when  using  the  "FidoNet
  1328.      dialer".   You  must insert the modem dial command prefix and suffix. 
  1329.      If this gadget is empty then the  BBS  ignores  the  start  time  (see
  1330.      below).  Here is an example phone number:
  1331.  
  1332.                                 ATDT024123280^M
  1333.  
  1334.      Where the "^M" is a control character specifier, see the "Text editor"
  1335.      for more information on control characters.
  1336.  
  1337.        Executes:   Your BBS can also be configured to execute a program  at
  1338.      any  time.   This gadget contains the program's filename and arguments
  1339.      (if any) you wish to execute.   If you wish,  you can use the AmigaDOS
  1340.      command  "Execute" to execute a script,  please refer to your AmigaDOS
  1341.      manual.
  1342.  
  1343.        Start times:  This is the 24 hour start time that the BBS will begin
  1344.      to  dial  a phone number or execute a program.   When you join a "Net"
  1345.      your network co-ordinator will allocate you with a dial  time.   If  a
  1346.      user is still online at this time they will be forced off the BBS even
  1347.      during a file transfer, including uploads (line 246 is given).  When a
  1348.      user  logs  on,  the BBS will compare the user's time remaining to the
  1349.      time before the  next  system  event.   If  the  user  has  more  time
  1350.      remaining than the time before the next system event,  then the user's
  1351.      time remaining will be adjusted and a waring will be given (line 245).
  1352.      The  BBS  will  remember  the  user's true time remaining for the next
  1353.      call.   The next system event will be taken into account when the user
  1354.      attempts to withdraw time from their time bank (BBS menu function 30 -
  1355.      Withdraw from the time bank).
  1356.  
  1357.        Max retries:   (Maximum retires)  This  is  the  maximum  number  of
  1358.      redial  attempts  that  the "FidoNet dialer" will try before exiting. 
  1359.      This value ranges from 1 to 500.
  1360.  
  1361.  
  1362.      Chapter 3                    M A X's BBS                      Page: 21
  1363.  
  1364.  
  1365.  
  1366.  
  1367.      Chapter 3                    M A X's BBS                      Page: 22
  1368.  
  1369.        Time out:  This is the time out value used for the "FidoNet dialer".
  1370.      This  value  will count down until it reaches zero (0),  in which case
  1371.      the "FidoNet dialer" will then try another redial attempt.  This value
  1372.      is in seconds and ranges from 1 to 500.
  1373.  
  1374.        Redial delay:   This is the amount of time that the "FidoNet dialer"
  1375.      will wait before attempting a redial.   This value is in  seconds  and
  1376.      ranges from 1 to 500.
  1377.  
  1378.        Fido  on:   This  is  the  24  hour  on  time for the time slot that
  1379.      reserves the BBS for FidoNet system callers only.  If this time is the
  1380.      same  as  the  "Fido  off" time (see below),  then the BBS will always
  1381.      accept human callers.   If a user tries to call in  the  FidoNet  only
  1382.      time slot,  then the message "FidoNet only, please call back..." (line
  1383.      261) is given.
  1384.  
  1385.        Fido off:   This is the 24 hour off time  for  the  time  slot  that
  1386.      reserves the BBS for FidoNet system callers only (see above).
  1387.  
  1388.        Future:  Undefined and reserved for future use.
  1389.  
  1390.        Auto  dialer:   This is the master enable switch for all three phone
  1391.      numbers and starting times.
  1392.  
  1393.        Auto execute:   This is the  master  enable  switch  for  all  three
  1394.      executes and starting times.
  1395.  
  1396.        Allow pickup:   This gadget enables/disables your BBS from accepting
  1397.      calls from another FidoNet  system.   If  turned  off,  the  BBS  will
  1398.      proceed straight into the logon text.  If turned on, the BBS will give
  1399.      the message "Hit <esc> twice or wait 30 seconds to enter  the  BBS..."
  1400.      (line  253).   The  BBS  distinguishes  the difference between a human
  1401.      caller and a FidoNet system caller by the initial response.  A FidoNet
  1402.      system  caller  will  send a control character to the answering BBS to
  1403.      start a FidoNet session.   A human caller will hit <esc> twice or wait
  1404.      30 seconds (time out).
  1405.  
  1406.        Allow send:   This gadget allows the old "TeLink" FidoNet systems to
  1407.      be sent their files when they call  your  system.   The  old  "TeLink"
  1408.      FidoNet  systems did not have password protection to stop fake systems
  1409.      from picking up other system's files.   If this gadget is  turned  off
  1410.      and  a  "TeLink"  FidoNet  system  calls your BBS,  then your BBS will
  1411.      happily accept files from the caller,  but will not send anything back
  1412.      and  hang-up.   This  is  regardless if they are a valid system in the
  1413.      "FidoNet mail distribution" window.  Note: This flag does not effect a
  1414.      "WaZOO" FidoNet system caller.
  1415.  
  1416.        Allow TeLink:  This enables/disables an old "TeLink" FidoNet session
  1417.      when answering an incoming call from another FidoNet system,  and when
  1418.  
  1419.  
  1420.      Chapter 3                    M A X's BBS                      Page: 22
  1421.  
  1422.  
  1423.  
  1424.  
  1425.      Chapter 3                    M A X's BBS                      Page: 23
  1426.  
  1427.      dialling another FidoNet system.  This was used for testing and should
  1428.      normally be turned on.
  1429.  
  1430.        Allow  WaZOO:   This enables/disables a "WaZOO" FidoNet session when
  1431.      answering an incoming call  from  another  FidoNet  system  and,  when
  1432.      dialling  another  FidoNet system.   If this flag is off,  the FidoNet
  1433.      session would normally fall back to the old "TeLink" FidoNet  session.
  1434.      This was used for testing and should normally be turned on.
  1435.  
  1436.        FidoNet only:   This stops human callers from using your BBS.   When
  1437.      turned on,  the BBS will only accept calls from other FidoNet systems.
  1438.      Use this gadget for a dedicated Hub FidoNet system.
  1439.  
  1440.        Show  ctrl  info:   (Show  control information)  This gadget is used
  1441.      when reading imported messages.   If turned on,  the BBS will show all
  1442.      the control information contained in an imported echo message.
  1443.  
  1444.        Update log:  This gadget enables/disables updates to the FidoNet log
  1445.      file.  All FidoNet transactions are logged with the date and time (see
  1446.      "Log files file path").
  1447.  
  1448.  
  1449.      FidoNet mail distribution:
  1450.  
  1451.      This window could be nick named the "Post Office".   This is where the
  1452.      echo  message sections are linked to echo mail "Area" names.   FidoNet
  1453.      message bundle files  contain  messages  which  are  categorized  into
  1454.      areas.   An  "Area"  is  a name or tag given to each message,  so that
  1455.      message importing programs (tossers) can  sort  the  InBound  messages
  1456.      into   the   local  BBS  message  base.    This  window  also  defines
  1457.      destinations and passwords of FidoNet systems.   Two  hundred  entries
  1458.      can  be  made,  which  should be plenty for most configurations.   The
  1459.      "FidoNet dialer" requires a destination address  to  be  defined.   If
  1460.      not,  the  "FidoNet  dialer"  will not respond to your dial requests. 
  1461.      Pseudo section numbers of 101,  102 and 103 are used to link  a  phone
  1462.      number with a destination address.   Section 101 means phone number 1.
  1463.      Section 102 means phone number 2.   Section 103 means phone number 3. 
  1464.      When  dialling  a remote FidoNet system,  the destination address must
  1465.      match the remote system's address to begin the  FidoNet  session.   If
  1466.      not, the session will abort.   Here are descriptions of the gadgets in
  1467.      this window:
  1468.  
  1469.        Sect:   (Section)  This gadget contains the echo message section you
  1470.      wish  to  link with the "Area" (see below).   The echo message section
  1471.      must have the "Ech" flag turned on.   It can  also  contain  a  pseudo
  1472.      section number for the "FidoNet Dialer" (see above).
  1473.  
  1474.        Area:  This gadget contains the "Area" name of the messages you wish
  1475.      to link with the above echo message section.   You can define your own
  1476.      "Area"  names if you wish to configure a private or new "Area",  or if
  1477.  
  1478.      Chapter 3                    M A X's BBS                      Page: 23
  1479.  
  1480.  
  1481.  
  1482.  
  1483.      Chapter 3                    M A X's BBS                      Page: 24
  1484.  
  1485.      you wish to use an existing "Area" then you can obtain  the  available
  1486.      "Area"  names  from  your  network co-ordinator.   This gadget must be
  1487.      blank when defining a phone number destination address.   "Area" names
  1488.      are always UPPER case.
  1489.  
  1490.        Dest  address:   (Destination  address)   This  gadget  contains the
  1491.      FidoNet destination address for new  and  imported  messages,  or  the
  1492.      FidoNet  destination  address  of  a  phone  number (see above).   The
  1493.      destination  address  is  in  the  format  Zone:Net/Node.Point.   This
  1494.      address would normally be your Hub,  or if you are configured as a Hub
  1495.      then the destination address would be the  FidoNet  systems  that  you
  1496.      support.   Note:  If  you  are  configuring a Hub then you will need a
  1497.      destination address for each FidoNet system that is  to  receive  that
  1498.      "Area"  (see  above).   Therefore,  one  "Area"  could  have  multiple
  1499.      destinations.
  1500.  
  1501.        Password:  This gadget contains the password that the calling system
  1502.      with the same FidoNet address as the FidoNet destination address, must
  1503.      have before your BBS will send their files.   When configuring a phone
  1504.      number entry,  this is the password that your BBS will send the remote
  1505.      FidoNet  system  (sections  101  to  103).   Passwords  are  not  case
  1506.      sensitive.
  1507.  
  1508.        LZH:   (Lharc)   This  gadget  is  used  to turn on the archiving of
  1509.      OutBound message bundle files.   The BBS uses the program  "Lharc"  to
  1510.      perform the archiving (see "FidoNet configure").  The OutBound message
  1511.      files can be archived at two different times.   They can  be  archived
  1512.      before  the  BBS  dials  a  remote  FidoNet  system  with the "FidoNet
  1513.      dialer".   In which case this gadget would be turned on for the  phone
  1514.      number  entry.   They  can  also  be archived at the end of a "Message
  1515.      import".   In which case this gadget would be turned  on  for  a  echo
  1516.      message  section  number entry.   Only the message bundle file for the
  1517.      above destination address is archived when this gadget is turned  on. 
  1518.      The BBS will generate a new archive for a destination once a day,  all
  1519.      archiving on the same day will be added to the existing archive.
  1520.  
  1521.        Top/Btm gadget:   (Top/Bottom)  Click on this gadget to move to  the
  1522.      first ten and last ten entries.
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.      Chapter 3                    M A X's BBS                      Page: 24
  1537.  
  1538.  
  1539.  
  1540.  
  1541.      Chapter 4                    M A X's BBS                      Page: 25
  1542.  
  1543.                             PULL DOWN MENU FUNCTIONS
  1544.                             ------------------------
  1545.  
  1546.      The  pull  down  menus  are divided into three menus.   The "BBS" menu
  1547.      contains general BBS functions.   The "Sysop" menu contains  functions
  1548.      to  do  with  maintenance  and  editing  of  the  data files (normally
  1549.      performed by the Sysop).  The "Config" menu contains all the functions
  1550.      associated  with  configuring  the BBS and BBS menus (see "Configuring
  1551.      the BBS").   Some or all of the  pull  down  menu  functions  will  be
  1552.      ghosted  when  either that function is in use,  or when it might clash
  1553.      with another function in use.   Some functions are only  used  when  a
  1554.      user is logged in.   If a "Carrier Detect" signal is received from the
  1555.      modem while  any  of  the  pull  down  menu  functions  are  activated
  1556.      (including a local login),  the BBS will notify you that a carrier has
  1557.      been detected.  You can either ignore it, or finish what you are doing
  1558.      and let the BBS answer the incoming call as usual.  If you do not want
  1559.      to be bothered by incoming calls then it is  best  to  turn  off  your
  1560.      modem  so that callers know that the BBS is offline.   This also stops
  1561.      the modem from accepting the call and wasting the caller's money.  The
  1562.      following  is a description of each pull down menu function as seen in
  1563.      the menus:
  1564.  
  1565.  
  1566.      BBS menu:
  1567.  
  1568.  
  1569.      Local login:
  1570.  
  1571.      This function starts a local BBS login session.   The local  login  is
  1572.      the  same  as  logging in from remote,  except the routines associated
  1573.      with the modem and serial port are deactivated.   Hence the  speed  at
  1574.      which  the  text  is printed is very fast ie.  there is no waiting for
  1575.      data to be sent out the serial port.   This will probably be the  most
  1576.      used  function as it is used to test and view the BBS menus when first
  1577.      setting up the BBS, and in reading and answering messages.  The "Twit"
  1578.      function is the quickest way the to exit the local login (see below).
  1579.  
  1580.  
  1581.      Chat on/off:
  1582.  
  1583.      This simply turns the BBS menu function 3 - Chat call, on and off.  At
  1584.      start-up  this  function is default on.   You can toggle the chat call
  1585.      function on and off at any time,  even when a user is logged  in.   If
  1586.      the  chat call function is switched off then the "Sysop is busy" (line
  1587.      39) message will be given when the user tries to page the Sysop.  This
  1588.      function  overrides  the  "Chat  on"  and  "Chat off" time slot in the
  1589.      "System configure" window.   Note:  A Sysop (access 5000) can page the
  1590.      local Sysop at any time regardless of the time or this flag.
  1591.  
  1592.  
  1593.  
  1594.      Chapter 4                    M A X's BBS                      Page: 25
  1595.  
  1596.  
  1597.  
  1598.  
  1599.      Chapter 4                    M A X's BBS                      Page: 26
  1600.  
  1601.      Chat interrupt:
  1602.  
  1603.      This function is only active when a user is logged in.   When  a  user
  1604.      has logged in you can use this function to chat interrupt at any time.
  1605.      This activates chat mode so that you can type to the user and they can
  1606.      type back to you.  You can also start the chat mode by hitting any key
  1607.      while a user is paging the Sysop using the BBS menu function 3 -  Chat
  1608.      call.   To  exit  chat  mode  the local Sysop must hit the <Esc> key. 
  1609.      Note:  The user can not exit chat mode.   After exiting chat mode  the
  1610.      BBS  will  continue  from  where the chat interrupt took place.   When
  1611.      typing to each other the character's colour changes depending  on  who
  1612.      is typing.  It is good practise to hit <Return> twice to signal to the
  1613.      other that you have finished typing and it is now the  other  person's
  1614.      turn.
  1615.  
  1616.  
  1617.      Countdown:
  1618.  
  1619.      This function is only active when a user is logged in.   If  for  some
  1620.      reason  you  need  to  force a user off the BBS but wish to do it in a
  1621.      nice way, then use this countdown function.   Once activated,  the BBS
  1622.      will give a warning message to the user (line 26), and the time set in
  1623.      the "System configure" window's countdown gadget will then become  the
  1624.      user's  time  remaining.   The  system  will  hang-up  when  the  time
  1625.      remaining reaches zero (0).   The time that  the  user  had  remaining
  1626.      before the countdown function was activated will be restored when they
  1627.      call back (or a new daily limit if it is a new  day).   The  countdown
  1628.      can  be reversed,  in which case the user's original time remaining is
  1629.      restored, and an appropriate message is given to the user (line 27).
  1630.  
  1631.  
  1632.      Printer/Output:
  1633.  
  1634.      This  function is only active when a user is logged in.   It opens the
  1635.      printer/output file for output.   When selected,  a window  requesting
  1636.      the  filename  of  the  output  file  is  opened.   The default output
  1637.      filename is "PRT:",  this is the AmigaDOS name for the  printer.   You
  1638.      can  also  send  the  output  to  disk by changing the filename in the
  1639.      requester.   Once the printer/output file is open,  everything seen on
  1640.      the  BBS  screen  will  be  captured  on disk or sent to the printer. 
  1641.      Selecting  this  function  again,   or  when  the  login  session   is
  1642.      terminated, will turn the printer off or close the output file.   This
  1643.      is handy when you want a hard copy of a message,  or  you  could  even
  1644.      monitor a complete session (if you have enough paper).
  1645.  
  1646.  
  1647.      Text import:
  1648.  
  1649.      This function is only active when a user is logged in (yourself).   It
  1650.      is  used  to  import text into the BBS from any text file.   It can be
  1651.  
  1652.      Chapter 4                    M A X's BBS                      Page: 26
  1653.  
  1654.  
  1655.  
  1656.  
  1657.      Chapter 4                    M A X's BBS                      Page: 27
  1658.  
  1659.      used at any time during login (including chat mode) but is intended to
  1660.      be used with the message editor.  Importing text is similar to hitting
  1661.      a macro key except the text is taken from an external text  file.   If
  1662.      you  are  using WorkBench 2.0 (or higher) the BBS will make use of the
  1663.      "asl.library"  file  requester  to  select  a  text  file.    If   the
  1664.      "asl.library"  is  not  available  then  you  will have to type in the
  1665.      filename and path into the small filename gadget that appears when you
  1666.      select this function.  Text will continue to be imported until the end
  1667.      of the text file is reached, or you re-select this function.
  1668.  
  1669.  
  1670.      TWIT:
  1671.  
  1672.      This function is only active when a user is logged in.  Selecting this
  1673.      will force the BBS to hang-up or "Twit" the current  user.   This  has
  1674.      been  named  "Twit"  because  it is intended to be used when a user or
  1675.      "Hacker" is abusing your BBS.   This is also a  quick  exit  from  the
  1676.      local login.
  1677.  
  1678.  
  1679.      Caller log:
  1680.  
  1681.      All users except Almighty Sysops (access 10000) are  recorded  in  the
  1682.      caller log file.   The caller log helps you locate a possible "Hacker"
  1683.      or to see if there has been any DOS read/write  errors.   Select  this
  1684.      function to view the caller log.  Use the arrow gadgets to move up and
  1685.      down in the caller log.  The log is viewed starting from the user most
  1686.      recently on the BBS.  The number of records in the log is specified in
  1687.      the "System configure" window, when this value is changed the log file
  1688.      is restarted.   Use the "Restart" gadget to restart the log file.  Use
  1689.      the "Top/btm" gadget to move to the top or bottom  of  the  log.   The
  1690.      caller log contains the following information:
  1691.  
  1692.                         User's name
  1693.                         Logon date & time
  1694.                         Logout date & time
  1695.                         Exit mode (see below)
  1696.                         Time used (minutes)
  1697.                         Number of messages read
  1698.                         Number of messages left
  1699.                         Number of uploads
  1700.                         Number of downloads
  1701.                         Connection bps rate
  1702.                         If attempted to page the local sysop (funct 3)
  1703.                         If used the CLI (funct 28)
  1704.  
  1705.      The user can exit the BBS in one of the following ways:
  1706.  
  1707.                         Normal (funct 1)
  1708.                         Slow bps rate (minimum bps rate)
  1709.  
  1710.      Chapter 4                    M A X's BBS                      Page: 27
  1711.  
  1712.  
  1713.  
  1714.  
  1715.      Chapter 4                    M A X's BBS                      Page: 28
  1716.  
  1717.                         User file full (new user)
  1718.                         Lost carrier
  1719.                         Security violation
  1720.                         Locked out (access = 0)
  1721.                         Out of time
  1722.                         Sleep disconnect
  1723.                         Twitted!
  1724.                         System event (FidoNet)
  1725.                         Forced hangup (auto insert %X)
  1726.                         DOS read error
  1727.                         DOS write error
  1728.                         Low memory error
  1729.  
  1730.      If  a  user  has  an access of zero then the user is locked out of the
  1731.      BBS,  any attempts to login will give the locked out message  and  the
  1732.      BBS  will hang-up!   A security violation can occur when a user enters
  1733.      the wrong password three times,  or when an attempt is made to  upload
  1734.      or  download a file with the filename "File.data".   This protects the
  1735.      BBS data file from being over written by another file  with  the  same
  1736.      filename (Hackers).  If a DOS read or write error has occurred then it
  1737.      is possible that the message base or file library has been  corrupted!
  1738.      Use the pull down menu functions "Optimize messages" and "Check files"
  1739.      in the "Sysop" menu to check the data files (see below).
  1740.  
  1741.  
  1742.      About. . .:
  1743.  
  1744.      This   function   will   open   a   window  with information about the
  1745.      version of M A X's BBS you have.   Included  in  this  window  is  the
  1746.      available "Chip" and "Fast" memory your system has.  If memory becomes
  1747.      low you may get low memory errors.    In which case you will  have  to
  1748.      free up memory or buy more RAM!
  1749.  
  1750.  
  1751.      Iconify:
  1752.  
  1753.      This function will close the BBS screen and open a small window in the
  1754.      WorkBench  screen.   When the BBS is iconified it can still be used by
  1755.      users!   To the user the BBS will look  no  different  whether  it  is
  1756.      iconified or not.   The advantage of iconifying the BBS is that "Chip"
  1757.      memory is freed up,  and the serial output is faster because  the  BBS
  1758.      does  not  have  to update the BBS screen.   When a user has logged on
  1759.      their name will appear in the small WorkBench window.   Click  on  the
  1760.      "Close  window"  gadget to close the small WorkBench window and to re-
  1761.      open the BBS screen.   The screen may look incomplete at first because
  1762.      all  screen output is lost when iconified.   You will have to wait for
  1763.      the screen to be redrawn,  especially when the user is using the  full
  1764.      screen  editor.   You  can iconify and re-open the screen at any time,
  1765.      even during a file transfer.  Note: During a file transfer or "Message
  1766.  
  1767.  
  1768.      Chapter 4                    M A X's BBS                      Page: 28
  1769.  
  1770.  
  1771.  
  1772.  
  1773.      Chapter 4                    M A X's BBS                      Page: 29
  1774.  
  1775.      import" the BBS may not respond to your request straight away,  but it
  1776.      will eventually (click once and wait).
  1777.  
  1778.  
  1779.      Quit:
  1780.  
  1781.      Selecting "Quit" will bring up a requester to confirm that you  really
  1782.      wish  to  exit  the program.   Selecting "Whoops!" will abort the quit
  1783.      request and return you back to the BBS,  just  in  case  you  selected
  1784.      "Quit"  by mistake.   Selecting "Okay" will cause the BBS to shut down
  1785.      and return to WorkBench or the "CLI" where it was originally started.
  1786.  
  1787.  
  1788.      Sysop menu:
  1789.  
  1790.  
  1791.      Add 15 mins:
  1792.  
  1793.      This function is only active after a user has logged in.   If you wish
  1794.      to increase the current user's time remaining without interrupting the
  1795.      user, then use this function.   Each time you select this function you
  1796.      will  add fifteen minutes to the user's time remaining.   A maximum of
  1797.      10000 minutes still applies, exceeding this will have no effect.   The
  1798.      time remaining will be set back to the daily limit when the user calls
  1799.      back the next day.   This function does not effect  the  user's  daily
  1800.      time limit.
  1801.  
  1802.  
  1803.      Online edit:
  1804.  
  1805.      This function is  only  active  when  a  user  has  logged  in.   When
  1806.      selected, it will freeze the current user and open a window similar to
  1807.      the "User editor" (see below).   You can edit any part of the  current
  1808.      user  including  their  name!   As this window is similar to the "User
  1809.      editor" the gadgets are not described here (see "User editor"  below).
  1810.      Once  you  have  finished  editing the current user,  click the "Close
  1811.      window" gadget to bring any changes into effect.   The user  can  then
  1812.      continue what they where doing before the interruption.
  1813.  
  1814.  
  1815.      User editor:
  1816.  
  1817.      This is a very powerful user editor.   When selected, the user file is
  1818.      loaded  into  memory  and  the  "User  editor" window is opened.   All
  1819.      editing of the user file is done in  memory  for  speed,  therefore  a
  1820.      large  user  file  is not recommended for standard 512K byte systems. 
  1821.      The size of the user file  depends  on  the  "Maximum  users"  in  the
  1822.      "System  configure"  window.   Once you have finished editing the user
  1823.      file either hit "Save" to save the changes,  or hit the "Close window"
  1824.      gadget to abort all changes.   There must be at least one user (you). 
  1825.  
  1826.      Chapter 4                    M A X's BBS                      Page: 29
  1827.  
  1828.  
  1829.  
  1830.  
  1831.      Chapter 4                    M A X's BBS                      Page: 30
  1832.  
  1833.      The "User editor" window also displays the date and time that the user
  1834.      was last on, and the total number of users deleted (see the "Inactive"
  1835.      gadget below).   The following are the descriptions of the gadgets  in
  1836.      this window:
  1837.  
  1838.        Up  and  Down arrows:   Use these gadgets to move to the next user. 
  1839.      The user file is in the logon order,  ie as new "Guest" users logon to
  1840.      your BBS they are appended to the user file.
  1841.  
  1842.        Name:  This gadget contains the user's name.  The user names must be
  1843.      unique, ie.  no two users can have the same name.   If the BBS finds a
  1844.      user  with the same name then the requester "User already exists" will
  1845.      appear and you can either "Edit" the name, or "Delete" that user.  The
  1846.      name field has a maximum of 40 characters.
  1847.  
  1848.        Suburb:   This  gadget contains the user's suburb.   You may wish to
  1849.      include a street name and number, it is up to you, ie.  change line 14
  1850.      in  the  "Text  editor" window.   The suburb field has a maximum of 39
  1851.      characters.
  1852.  
  1853.        Password:   This gadget contains the user's  password.   It  is  not
  1854.      recommended that you change the user's password unless asked to by the
  1855.      user.   Sometimes a user forgets their password.   The easiest way  to
  1856.      resolve  this  is to delete this user so that they can re-logon.   The
  1857.      password is always UPPER case.  When the user enters their password at
  1858.      logon  it is not case sensitive.   The password field has a maximum of
  1859.      20 characters.
  1860.  
  1861.        Phone #:   This gadget contains the user's phone number.   Edit line
  1862.      15  in  the "Text editor" window to ask the user to include area codes
  1863.      if you wish.  The phone number field has a maximum of 20 characters.
  1864.  
  1865.        Computer:   This gadget  contains  the  user's  description  of  the
  1866.      computer  they  use.   You can tell what files a user can use from the
  1867.      type of computer they have.   Sometimes users complain that  they  can
  1868.      not use a file from your file library,  a quick look here might reveal
  1869.      that the user is trying to use an Amiga file on an IBM!   The computer
  1870.      description field has a maximum of 20 characters.
  1871.  
  1872.        Time remaining:  This is the time remaining of the user's daily time
  1873.      limit.   The time remaining will  be  refreshed  to  the  daily  limit
  1874.      automatically when the user logs on on a new day.   Editing this field
  1875.      will only be in effect up until midnight on the day the user was  last
  1876.      on.  Maximum is 10000 and is in minutes.
  1877.  
  1878.        Access  level:   The  access  level  of the user must be the same or
  1879.      higher than the access level of a BBS menu function  before  the  user
  1880.      can  select  that function.   The access level of the user must be the
  1881.      same or higher than the  access  level  in  the  "Sections  configure"
  1882.      window before the user can use that section.   An access level of zero
  1883.  
  1884.      Chapter 4                    M A X's BBS                      Page: 30
  1885.  
  1886.  
  1887.  
  1888.  
  1889.      Chapter 4                    M A X's BBS                      Page: 31
  1890.  
  1891.      (0) means the  user  has  been  locked  out  of  the  BBS.   The  file
  1892.      "LockOut.text"  is  sent  to the user then the BBS will hang-up when a
  1893.      locked out user attempts to logon.   An access level of 5000  or  more
  1894.      means Sysop access!  A Sysop has certain privileges over normal users.
  1895.      Here is a list:
  1896.  
  1897.               Read all private messages in section 0
  1898.               Delete any message
  1899.               Lock messages
  1900.               Forward messages
  1901.               Edit users with lower access levels (see BBS menu funct 26)
  1902.               Download and read a "New" file
  1903.               Delete any file (see BBS menu funct 21)
  1904.               Download and upload at any time.
  1905.               Page the local Sysop at any time.
  1906.               Sees all real names when alias' are used
  1907.  
  1908.      An access level of 10000 (maximum) means Almighty Sysop!.  An Almighty
  1909.      Sysop has all of the above privileges plus:
  1910.  
  1911.               Not recorded in the caller log
  1912.               Edit any user (see BBS menu funct 26)
  1913.  
  1914.        Time  limit:   This  is the user's daily online time limit.   When a
  1915.      user logs on on a new day this value becomes their time remaining  for
  1916.      the  whole  day.   If  the  user  logs  on  on the same day,  the time
  1917.      remaining from the last login is used (see "User defaults").   Maximum
  1918.      value of 10000 and is in minutes.
  1919.  
  1920.        D/U  ratio:   (Download/Upload  ratio)   This  is  a download versus
  1921.      upload  ratio  to  help  prevent  users  downloading  files  and   not
  1922.      contributing  any uploads (file hogs).   If a user tries to download a
  1923.      file when their number of downloads  versus  uploads  is  higher  than
  1924.      their "D/U ratio" value,  then the message "You have exceeded your D/U
  1925.      ratio" (line 173) is given.   A value of zero (0) disables this check.
  1926.      Maximum  of  10000  and  is  in  actual  number  of  successful  files
  1927.      transferred.
  1928.  
  1929.        Lt ms rd:   (Last message read)  This is the highest message read by
  1930.      this  user.   It  is  used  by the BBS as a reference to check for new
  1931.      messages, ie. higher message numbers.  Note: This value is only stored
  1932.      at  a  normal  log  out  (see BBS menu function 1 - Log out).   If the
  1933.      message base has been lost or restarted then a global user  edit  (see
  1934.      below) should be done with this value to set it to the highest message
  1935.      in the BBS.
  1936.  
  1937.        Screen length:   This is the number of lines per page for this user.
  1938.      This is currently only being used in conjunction with the "Pause" flag
  1939.      (see below).   The BBS counts the number of lines since the last input
  1940.  
  1941.  
  1942.      Chapter 4                    M A X's BBS                      Page: 31
  1943.  
  1944.  
  1945.  
  1946.  
  1947.      Chapter 4                    M A X's BBS                      Page: 32
  1948.  
  1949.      or pause.   When it reaches this value  it  will  pause.   This  value
  1950.      ranges from 10 to 200.
  1951.  
  1952.        Calls:   This  is a count of the total number of calls this user has
  1953.      made.  Used for statistics only.   Note:  A local login is not counted
  1954.      as a call.
  1955.  
  1956.        Messages:   This  is a count of the total number of messages written
  1957.      by the user.  Used for statistics only.
  1958.  
  1959.        Uploads:   This is a count of the total number of  successful  files
  1960.      uploaded to the BBS.  Used with the "D/U ratio" (see above).
  1961.  
  1962.        Dnloads:   This  is  a count of the total number of successful files
  1963.      downloaded from the BBS.  Used with the "D/U ratio" (see above).
  1964.  
  1965.        Time bnk:   (Time bank)  This is the user's time bank balance.   The
  1966.      time  bank  is a means where the user can deposit and withdraw time to
  1967.      and from their daily time limit.   See BBS menu functions 29  to  31. 
  1968.      This value is in minutes and has a maximum of 10000.
  1969.  
  1970.        Protocol:   This is the user's default file transfer protocol.  This
  1971.      value can be use when a user wishes to  use  the  same  file  transfer
  1972.      protocol  all the time,  and therefore does not have to select it each
  1973.      time they use BBS menu functions 23 and 24.   Here is a list of values
  1974.      and the associated protocol:
  1975.  
  1976.                                0 - No default (BBS will ask)
  1977.                                1 - XModem
  1978.                                2 - XModem CRC
  1979.                                3 - XModem 1K
  1980.                                4 - YModem (batch)
  1981.                                5 - YModem-g
  1982.                                6 - ZModem
  1983.  
  1984.        Future:  Undefined and reserved for future use.
  1985.  
  1986.        Rd:   (Read  access  flag)   This  is  the  read  access  flag which
  1987.      specifies whether or not a user can read messages (regardless of their
  1988.      access level).
  1989.  
  1990.        Wr:   (Write  access  flag)   This  is  the  write access flag which
  1991.      specifies whether  or  not  a  user  can  write  or  leave  a  message
  1992.      (regardless of their access level).
  1993.  
  1994.        Up:   (Upload  access  flag)   This  is the upload access flag which
  1995.      specifies whether or not a user can upload files (regardless of  their
  1996.      access level).
  1997.  
  1998.  
  1999.  
  2000.      Chapter 4                    M A X's BBS                      Page: 32
  2001.  
  2002.  
  2003.  
  2004.  
  2005.      Chapter 4                    M A X's BBS                      Page: 33
  2006.  
  2007.        Dn:   (Download access flag)  This is the download access flag which
  2008.      specifies  whether  or  not  a  user can download files (regardless of
  2009.      their access level)
  2010.  
  2011.        Bltn:   (Bulletin read flag)  This flag is set by the BBS  when  the
  2012.      user has read the BBS news bulletin.  If this flag is not set when the
  2013.      user logs on, then the news bulletin text file is sent to the user and
  2014.      this  flag  is  set.   Use this flag and the "Global" edit gadget (see
  2015.      below) to force all users to read a new news bulletin.
  2016.  
  2017.        ANSI:   (ANSI on/off flag)  This flag is set by the user to tell the
  2018.      BBS whether or not to strip the ANSI colour codes from the text.
  2019.  
  2020.        FSE:   (Full  Screen  Editor  flag)  This flag is set by the user to
  2021.      tell the BBS whether or not the user wants  to  use  the  full  screen
  2022.      editor  to write messages.   Some terminal programs do not support all
  2023.      the ANSI codes required by the  full  screen  editor.   See  the  full
  2024.      screen editor help file called "FSEHelp.text".
  2025.  
  2026.        Pause:   (Pause  flag)  This flag is set by the user to tell the BBS
  2027.      whether or not to pause after every full screen (see  "Screen  length"
  2028.      above).
  2029.  
  2030.        Cls:   (Clear screen flag)  This flag is set by the user to tell the
  2031.      BBS whether or not to send the clear screen code "Form Feed"  (^L)  to
  2032.      the user.  Note: The full screen editor forces clear screen codes.
  2033.  
  2034.        Lck:   (Locked  user  flag)   This  flag is used to stop a user from
  2035.      being deleted when using the "Inactive" gadget (see below).
  2036.  
  2037.        GFD:   (Get File Descriptions)  This flag is set by the BBS  when  a
  2038.      file  has  been  uploaded  by one of the batch file transfer protocols
  2039.      (YModem or ZModem).   It is then reset when the user has  typed  in  a
  2040.      description  for  all  files  uploaded.   This  is useful for when the
  2041.      carrier is lost after the user manages to successfully upload  one  or
  2042.      more files.   When the user logs on next and this flag is set, the BBS
  2043.      will search the file library for any files that have been uploaded  by
  2044.      this user and are missing the file description.  The BBS will then ask
  2045.      for the missing file descriptions.  It can also be set by the Sysop to
  2046.      force a check.
  2047.  
  2048.        Mask:   These  flags  are  used  with  the "Global" edit gadget (see
  2049.      below).  When any one of these "Mask" flags are set, the flag or value
  2050.      next  to  it will become the global setting or value when the "Global"
  2051.      gadget is clicked.   Flags or values with their "Mask" flag turned off
  2052.      will not be changed in the global edit.
  2053.  
  2054.        Comment:   This  gadget  contains a comment,  or anything about this
  2055.      user.   This field is intended for your use only but it  can  be  used
  2056.      along with the auto insert feature "%j" (see "Customizing the BBS") to
  2057.  
  2058.      Chapter 4                    M A X's BBS                      Page: 33
  2059.  
  2060.  
  2061.  
  2062.  
  2063.      Chapter 4                    M A X's BBS                      Page: 34
  2064.  
  2065.      give individual and unique "one liners"  to  the  user.   The  comment
  2066.      field has a maximum of 99 characters.
  2067.  
  2068.        Top/Btm:  (Top/Bottom)  This gadget is used to get to the top of the
  2069.      user file if you are not already there,  or to the bottom of the  user
  2070.      file  if you are at the top.   This is useful to get to the top of the
  2071.      user file before performing a search (see below).
  2072.  
  2073.        Search:   This gadget will do a search from the current position  to
  2074.      the  end  of  the user file for a match with the text in the "Search:"
  2075.      gadget box.  The search is not case sensitive and will search all text
  2076.      fields, including the comment.  Partial strings can be used.
  2077.  
  2078.        Guests:   This  gadget will do a search from the current position to
  2079.      the end of the user file for users with the "Guest" access  level  (as
  2080.      defined  in  the "User defaults (Guest)" window).   Use this gadget to
  2081.      find and check new users.
  2082.  
  2083.        Member:   This gadget will set all the values and flags  defined  in
  2084.      the "User defaults (Member)" window into the current user's file.  Use
  2085.      this gadget to give any user a Member's status with one click!
  2086.  
  2087.        Add:  This gadget will append a new user to the user file.   The new
  2088.      user  will automatically have a Member's status,  and you will have to
  2089.      enter the user's name and details.
  2090.  
  2091.        Delete:   This gadget will delete the current  user  from  the  user
  2092.      file.   It  may be more appropriate to lock a user out (access 0) than
  2093.      to delete them.   Once deleted,  the user will have to re-logon  as  a
  2094.      Guest.  Note: You can not delete the first user (you).
  2095.  
  2096.       Inactive:   This gadget will delete all inactive users.   An inactive
  2097.      user is one that has not logged on the BBS for the amount of  days  in
  2098.      the  "Inactive:"  gadget box.   The number of days is from the current
  2099.      system date,  so be sure that your system clock is set to the  correct
  2100.      date!   The  default  inactivity  is ninety days (three months).   The
  2101.      "Lock" flag (see above) is used to stop a user from being  deleted  as
  2102.      inactive  (the  user  may  be  on  holidays or their computer is being
  2103.      repaired).  The "Total deleted:" number is how many users were deleted
  2104.      by  this  function  plus  the  number of users deleted by the "Delete"
  2105.      gadget (see above) if any.
  2106.  
  2107.        Global:   This gadget will do a  global  edit  of  all  users.   The
  2108.      "Global" edit gadget is used in conjunction with the "Mask" flags (see
  2109.      above).  When you do a global edit, each "Mask" flag that is turned on
  2110.      will have the flag or value next to it become the same for every user!
  2111.      You can do a global edit on  the  user's  access  level,  time  limit,
  2112.      download/upload ratio,  last message read, time bank value and all the
  2113.      flags.
  2114.  
  2115.  
  2116.      Chapter 4                    M A X's BBS                      Page: 34
  2117.  
  2118.  
  2119.  
  2120.  
  2121.      Chapter 4                    M A X's BBS                      Page: 35
  2122.  
  2123.        Purge:   This gadget will purge or delete all users except the first
  2124.      (you) in the user file.  It will also reset the "Total calls" count to
  2125.      zero.
  2126.  
  2127.        Save:   This gadget will save all changes (if  any)  permanently  on
  2128.      disk.   If  you  wish  to  exit  the  "User editor" without saving the
  2129.      changes then hit the "Close window" gadget instead.
  2130.  
  2131.  
  2132.      Files editor:
  2133.  
  2134.      This  is  a  powerful  file library editor.   When selected,  the file
  2135.      library data file is loaded into memory and the "Files editor"  window
  2136.      is  opened.   All  editing  of  the  file library data file is done in
  2137.      memory for speed,  therefore a large file library is  not  recommended
  2138.      for  standard  512K  byte systems.   The size of the file library data
  2139.      file depends on the "Max" value for each file section,  added together
  2140.      in the "Sections configure" window.  A file library of 300 files would
  2141.      need a data file of about 60K bytes.   Once you have finished  editing
  2142.      the  file  library  either hit "Save" to save the changes,  or hit the
  2143.      "Close window" gadget to abort all changes.   You must have  at  least
  2144.      one  valid file section (see "Sections configure") to use this editor.
  2145.      When you first select the "File editor" a check of the sections  count
  2146.      is  done.   If  a  discrepancy  is found a "File sections count error"
  2147.      requester will be given.  A "File sections count error" can occur when
  2148.      the  data  file  is corrupted due to a DOS read/write error;  you will
  2149.      have to restart (purge) the file library.
  2150.  
  2151.      The "Files editor" window displays the name of the  section  that  the
  2152.      file is in.  If a file is deleted then the section name will change to
  2153.      "** Deleted **".   Files which are deleted by the BBS menu function 21
  2154.      - Delete a file,  are deleted from disk at the time of that function. 
  2155.      Files which are deleted using the "Delete" gadget (see below) are  not
  2156.      deleted on the disk until the "Save" gadget is used.  This gives you a
  2157.      chance to change your mind.   All deleted files will be  removed  from
  2158.      the  file  library  data  file  when the "Save" gadget is used.   This
  2159.      window also displays the time that the file was uploaded,  the size of
  2160.      the  file  and the number of times that the file has been downloaded. 
  2161.      Note: If a file is "New" ie. not public, then the download number will
  2162.      be displayed as "New".   The two filenames above and below the current
  2163.      file are display and are colour coded as followed:
  2164.  
  2165.                                 Cyan - Normal
  2166.                                Green - Locked
  2167.                               Yellow - New
  2168.                                  Red - Deleted
  2169.  
  2170.        The following are descriptions of all the gadgets in this window:
  2171.  
  2172.  
  2173.  
  2174.      Chapter 4                    M A X's BBS                      Page: 35
  2175.  
  2176.  
  2177.  
  2178.  
  2179.      Chapter 4                    M A X's BBS                      Page: 36
  2180.  
  2181.        Up and Down arrows:   Use the "Arrow" gadgets to move  to  the  next
  2182.      file.   The file library data file is in uploaded order, ie.  as files
  2183.      are uploaded or added they are appended to the data file.
  2184.  
  2185.        Section #:   This gadget contains the section number.   Changing the
  2186.      section number here will move the file to another section,  similar to
  2187.      forwarding a message.   Only valid file sections can be  entered  (see
  2188.      "Sections configure").
  2189.  
  2190.        Lock:   (Lock flag)  This is the gadget used to roll lock the file. 
  2191.      As a file section becomes full ie. maximum files, the oldest file will
  2192.      be  deleted to make room for the new file.   Set this flag to stop the
  2193.      file from being roll deleted.  It also stops the user who uploaded the
  2194.      file  from  deleting it using the BBS menu function 21 - Delete a file
  2195.      (see "BBS menu functions").
  2196.  
  2197.        Filename:   This gadget contains the filename.   If you  change  the
  2198.      filename  of  a  file in the data file you must remember to change the
  2199.      filename of that file on disk!   If you do not match the filename with
  2200.      the  filename  of  the file on disk,  the "File not online" (line 164)
  2201.      message will be  given  when  a  user  tries  to  access  that  file. 
  2202.      Filenames  must  be  unique  and are not case sensitive.   The maximum
  2203.      characters in this field is 40.
  2204.  
  2205.        Description:   This gadget contains the description  of  the  file. 
  2206.      File descriptions are typed in by the user as they are uploaded.  If a
  2207.      file description is missing,  which can occur when the carrier is lost
  2208.      during a batch upload, use the "Get File Descriptions" flag (see "User
  2209.      editor").   The "Get File Descriptions" flag will be set automatically
  2210.      by  the  BBS  if the carrier is lost.   The maximum characters in this
  2211.      field is 59.
  2212.  
  2213.        From:   This gadget contains the name of the user who  uploaded  the
  2214.      file.  If a file is added (see below) then the Sysop name in the "Text
  2215.      editor" line 0 is used in this field.   The maximum characters in this
  2216.      field is 40.
  2217.  
  2218.        Alias:   This  gadget contains the alias used by the user (if any). 
  2219.      When files are listed and an alias exists,  then the alias is used for
  2220.      the uploader's name.  The maximum characters in this field is 40.
  2221.  
  2222.        Top/Btm:  (Top/Bottom)  This gadget is used to get to the top of the
  2223.      files,  or to the bottom of the files if you are already at the  top. 
  2224.      This  is  useful  to  get  to the top of the files before performing a
  2225.      search (see below).
  2226.  
  2227.        Search:   This gadget will do a search from the current position  to
  2228.      the end of the files for a match with the text in the "Search:" gadget
  2229.      box.  The search is not case sensitive and will search all text fields
  2230.      of each file.  Partial strings can be used.
  2231.  
  2232.      Chapter 4                    M A X's BBS                      Page: 36
  2233.  
  2234.  
  2235.  
  2236.  
  2237.      Chapter 4                    M A X's BBS                      Page: 37
  2238.  
  2239.        New:   This gadget will do a search from the current position to the
  2240.      end  of the files for "New" files.   A "New" file is one that has been
  2241.      uploaded and not cleared using the "Public" gadget (see  below).   You
  2242.      can make all new uploads public by setting the "New files public" flag
  2243.      in the  "System  configure"  window.   All  "New"  files  can  not  be
  2244.      downloaded  or  read  until  made  public.   This  is  useful  to stop
  2245.      copyright material from being uploaded and downloaded before  a  Sysop
  2246.      can check/delete it.   Note: Sysops (access 5000) can download a "New"
  2247.      file.
  2248.  
  2249.        Public:   This gadget will make a "New" file (see above)  accessible
  2250.      to normal users.
  2251.  
  2252.        Add:   This gadget will add a new file.  Added files are appended to
  2253.      the file library data file.   If  you  are  using  WorkBench  2.0  (or
  2254.      higher)  the  BBS will make use of the "asl.library" file requester to
  2255.      select a file.   If the "asl.library" is not available then  you  will
  2256.      have  to  type  in  the  filename.   When using the "asl.library" file
  2257.      requester,  and the file you have selected is not in one of the  three
  2258.      files  file  paths,  then  it is automatically copied from the current
  2259.      path into the files file path #1.   The file must be found in  one  of
  2260.      the  three  files  file  paths (see "System configure") before you can
  2261.      continue.   If not found,  the BBS will bring up  a  requester  saying
  2262.      "Can't find that file".   You can either "Delete" that file, or select
  2263.      "Whoops!" to edit the filename or select another file.   Once the file
  2264.      is found,  the BBS will then fill in the size of the file.   Files are
  2265.      added to the first valid file section found,  it is up to you to  move
  2266.      them  into  the  correct  file  section.   You  must  also type in the
  2267.      description of the file.   The Sysop name (line  0)  is  used  as  the
  2268.      "From:" name.
  2269.  
  2270.        Delete:  This gadget will delete the current file.  The section name
  2271.      will change to "** Deleted **" when a file is deleted.   The  file  is
  2272.      removed  from the files library data file,  and deleted from disk when
  2273.      the "Save" gadget is used (see below).   You can effectively un-delete
  2274.      a file by exiting the files editor using the "Close window" gadget.
  2275.  
  2276.        Purge:   This  gadget  will  purge  or delete every file in the file
  2277.      library!   It is used to  restart  your  file  library  (see  "Delete"
  2278.      above).
  2279.  
  2280.        Save:   This  gadget  will  save all changes (if any) permanently on
  2281.      disk.   If you wish to exit the  "Files  editor"  without  saving  the
  2282.      changes,  then  hit the "Close window" gadget instead.   Deleted files
  2283.      will be deleted from disk when saving.
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.      Chapter 4                    M A X's BBS                      Page: 37
  2291.  
  2292.  
  2293.  
  2294.  
  2295.      Chapter 4                    M A X's BBS                      Page: 38
  2296.  
  2297.      Check files:
  2298.  
  2299.      This function performs a check of your file library.   When  selected,
  2300.      the  file library data file is loaded into memory and a sections count
  2301.      check is made.   If a discrepancy is  found  a  "File  sections  count
  2302.      error"  requester  will  be given.   A "File sections count error" can
  2303.      occur when the data file is corrupted due to a DOS  read/write  error;
  2304.      you  will have to restart (purge) the file library (see "Files editor"
  2305.      above).   After the sections  count  check,  the  "Checking  files..."
  2306.      window  is  opened.   As each file is checked,  it's name and size are
  2307.      shown in this window.  The filename is firstly checked to see if it is
  2308.      unique.   If not, a requester "File already exists" will be displayed,
  2309.      click on "Continue" when ready.   A check is then made to see  if  the
  2310.      file actually exists in one of the three files file paths.   If not, a
  2311.      requester "Can't find that file" is displayed.  You can either "Retry"
  2312.      or skip this file and "Continue".  A file may not exist because it has
  2313.      been deleted from disk,  or the file has been renamed on disk but  not
  2314.      in  the data file,  or visa versa.   A file size check is also made to
  2315.      check that the size of the file on disk is the same as the  file  size
  2316.      in the data file.   If the file sizes do not match,  then a "File size
  2317.      has changed" requester is given.   You can then either skip this  file
  2318.      and "Continue",  or click on "Fix it!" to correct the size of the file
  2319.      in the data file.   The file size may change if the file has been over
  2320.      written,  or  if  the  file  was  archived  (compressed)  after it was
  2321.      uploaded.  A check is now made to see if the file size is too large as
  2322.      specified  in the "System configure" window.   In this case a "File is
  2323.      too big" requester warning is given, hit "Continue" when ready.  After
  2324.      the  file  check  is completed,  changes in the data file are saved on
  2325.      disk (if any).   Another final check is then made to find  lost  files
  2326.      that  may  exist in one of the three files file paths,  but not in the
  2327.      file library data file.   A requester "Lost file" will let you know if
  2328.      any are found, click on "Continue" when ready.  Hit the "Close window"
  2329.      gadget at any time to abort the file check.
  2330.  
  2331.  
  2332.      Optimize messages:
  2333.  
  2334.      This  function  will  load  all  the  message  files into memory to be
  2335.      optimized. Because of the nature of all disk file systems, any file on
  2336.      a  disk  can  grow  in  size  but  never shrink unless completely over
  2337.      written by a new file.   Therefore when new messages are saved in  the
  2338.      data base, the BBS will try to store the message in the space taken up
  2339.      by a deleted message.   If the BBS can not find a space big enough  to
  2340.      fit the message, or there are no deleted messages, then the message is
  2341.      appended to the message files.   The message files  are  optimized  by
  2342.      loading  them  into  memory,  removing all deleted messages and unused
  2343.      space,  and then saving them back on disk.   Of course the larger  the
  2344.      message base the more memory required to use this function.   When the
  2345.      optimizer has finished,  a requester will let you know how many  bytes
  2346.      of  disk  space was saved (if any).   The message base is also checked
  2347.  
  2348.      Chapter 4                    M A X's BBS                      Page: 38
  2349.  
  2350.  
  2351.  
  2352.  
  2353.      Chapter 4                    M A X's BBS                      Page: 39
  2354.  
  2355.      for possible corruption due to DOS read/write errors,  if this is  the
  2356.      case then the message base will have to be restarted.
  2357.  
  2358.  
  2359.      PURGE MESSAGES:
  2360.  
  2361.      This function will purge all or  parts  of  the  message  base.   When
  2362.      selected the "PURGE MESSAGES" window is opened.   All deleted messages
  2363.      can not be restored, so use this function with caution.  This function
  2364.      would  normally  be  followed by the "Optimize messages" function (see
  2365.      above).  The following are descriptions of the gadgets in this window:
  2366.  
  2367.        "Section:":   This gadget contains  the  message  section  that  the
  2368.      "Received" and "Section" gadgets (see below) act on.
  2369.  
  2370.        Received:   This  gadget  will  delete  all  messages that have been
  2371.      received or read by the user that they are addressed to.  It will only
  2372.      effect  the  section that the "Section:" gadget (see above) contains. 
  2373.      This is useful to clean up the private message section  (section  0). 
  2374.      Note: Locked messages will not be deleted.
  2375.  
  2376.        Section:   This  gadget will delete an entire message section.   The
  2377.      section is specified in the "Section:" gadget (see  above).   This  is
  2378.      useful if you rename a message section,  or wish to remove an inactive
  2379.      message section.
  2380.  
  2381.        Restart:   This gadget will restart the message base.   All messages
  2382.      are lost!  Use with caution.
  2383.  
  2384.  
  2385.      Force FidoNet:
  2386.  
  2387.      This menu function will bring up a sub menu with the phone number  you
  2388.      wish  to  force.   The  BBS will normally auto dial your FidoNet phone
  2389.      numbers at the specified time (see "FidoNet configure").
  2390.  
  2391.  
  2392.      Force execute:
  2393.  
  2394.      This  menu  function  will bring up a sub menu with the program number
  2395.      you wish to force.   The BBS will normally auto execute your  programs
  2396.      at the specified time (see "FidoNet configure").
  2397.  
  2398.  
  2399.      Force msg import:
  2400.  
  2401.      This menu function will force a "Message import".  Normally a "Message
  2402.      import" will be done when a file is received during a FidoNet session.
  2403.      The InBound FidoNet files file path is checked for  message  bundles. 
  2404.      If  a message bundle is found it will extract the bundle using "Lharc"
  2405.  
  2406.      Chapter 4                    M A X's BBS                      Page: 39
  2407.  
  2408.  
  2409.  
  2410.  
  2411.      Chapter 4                    M A X's BBS                      Page: 40
  2412.  
  2413.      (which should be found in your "C" directory) if necessary.   It  will
  2414.      then read in each message bundle and process the messages contained in
  2415.      the file,  according to the "FidoNet mail distribution"  window.   The
  2416.      "Message  import" will continue until no more message files are found.
  2417.      It will then archive the OutBound message  bundles  using  "Lharc"  if
  2418.      required  (if  any).   The program "Lharc" is available from most good
  2419.      Amiga BBS's and is written by Paolo Zibetti.   M A X's BBS was  tested
  2420.      with  "Lharc"  version  1.30  but  should  work with versions 1.30 and
  2421.      later.   During a "Message import" the  "DTR"  signal  is  dropped  to
  2422.      prevent the modem from answering any incoming calls.
  2423.  
  2424.  
  2425.      Config menu:
  2426.  
  2427.      See the chapter "Configuring the BBS" for the use and  description  of
  2428.      this pull down menu.
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.      Chapter 4                    M A X's BBS                      Page: 40
  2465.  
  2466.  
  2467.  
  2468.  
  2469.      Chapter 5                    M A X's BBS                      Page: 41
  2470.  
  2471.                                BBS MENU FUNCTIONS
  2472.                                ------------------
  2473.  
  2474.      The  BBS  menu  functions are the functions available to the users who
  2475.      have logged on your BBS.   The BBS menus are configured in  the  "Menu
  2476.      editor" window (see "Configuring the BBS").  Each function is numbered
  2477.      and selected by the user with a single key press.   All BBS menus have
  2478.      "Hot  keys".   A "Hot key" means that the key can be pressed while the
  2479.      menu is being printed/sent.   As users become familiar with  your  BBS
  2480.      menus,  they  can  use  the  "Hot keys" to select the desired function
  2481.      without having to wait for the menu to be  drawn.   Pressing  "Return"
  2482.      will  reprint/resend the current menu.   Some functions have their own
  2483.      sub menus,  in which case the key presses are fixed  and  can  not  be
  2484.      changed.   The  sub  menus  have  text  files which can be edited (see
  2485.      "Customizing the BBS).   Some functions require  extra  parameters  to
  2486.      work  -  these  are  entered  in  the "Extra" and "Filename/Name/Dest"
  2487.      gadgets in the "Menu editor".   If a  function,  when  selected,  just
  2488.      returns  (reprints/resends  the current menu),  then you have probably
  2489.      entered a bad parameter or section.   Users  must  have  the  same  or
  2490.      higher access to be able to select that menu function.   Each menu has
  2491.      a separate text file which is what is seen by the user.   You can hide
  2492.      parts  of  menus,  or  parts  of any text file from users depending on
  2493.      their access level by using the "@n" code (see "Customizing the BBS").
  2494.      Sample  menus are supplied with the BBS.   You can use these or change
  2495.      them to suit your needs and imagination (see "Customizing the  BBS"). 
  2496.      All  BBS  menu  functions  will accept "S" to stop or "Space" to pause
  2497.      (hit any key to continue) when listing, or printing a text file.   The
  2498.      file  "MenuFunctions.text"  is  a  summary  of  the BBS menu functions
  2499.      currently available.   Print out this file and have it with you  as  a
  2500.      quick  look-up for editing the menus.   The following are descriptions
  2501.      for the BBS menu functions:
  2502.  
  2503.  
  2504.      Function 1 - Log out:
  2505.  
  2506.      This function is used by the user to log out and finish the session on
  2507.      the BBS.   When selected the "last message read" by the user is stored
  2508.      in the user file.   Any other method of exiting the BBS (lost carrier,
  2509.      Twitted etc) will not store/remember the "last message  read"  by  the
  2510.      user.   If you are reading your messages quickly,  and you do not wish
  2511.      to answer them during this login,  then "Twit" yourself  so  that  the
  2512.      "last message read" is not updated.   You can return to those messages
  2513.      during your next login.  If a user looses the carrier for some reason,
  2514.      they  can  return  to their messages at the next login.   This file is
  2515.      printed/sent when logging out:
  2516.  
  2517.                                 LogOut.text
  2518.  
  2519.      Note:  Pause is forced off when printing/sending  this  file  and  the
  2520.      "LogIn.text" file.  The BBS will then hang-up on the user (by dropping
  2521.  
  2522.      Chapter 5                    M A X's BBS                      Page: 41
  2523.  
  2524.  
  2525.  
  2526.  
  2527.      Chapter 5                    M A X's BBS                      Page: 42
  2528.  
  2529.      the "Data Terminal Ready" signal).   Also note that If another program
  2530.      has also opened the "serial.device" in shared mode,  then the BBS will
  2531.      not be able to drop the "DTR" signal until the  other  program  closes
  2532.      the "serial.device".
  2533.  
  2534.  
  2535.      Function 2 - Goto menu: (Menu #)
  2536.  
  2537.      This function will "Goto" the menu number in the "Extra"  gadget.   If
  2538.      the  BBS  can  not  find  that  menu number then it will return to the
  2539.      current menu.  This is how you move from one menu to another.
  2540.  
  2541.  
  2542.      Function 3 - Chat call: (# of plays)
  2543.  
  2544.      This function is used to call or page the local Sysop for a chat.   If
  2545.      "Chat On/Off" is turned off (see the pull  down  menu  function  "Chat
  2546.      On/Off"), then it will give the "Sysop is busy" (line 39) message.  If
  2547.      the current system time is not in  the  time  slot  specified  in  the
  2548.      "System  configure"  window,  then  the  "Sysop is not available,  try
  2549.      between..." (line 40) message is given.  If "Chat On/Off" is on and is
  2550.      in  the  right time slot,  then the chat sound sample is played.   The
  2551.      "Extra" gadget contains the number of times the chat  sample  will  be
  2552.      played.   While  the chat sample is being played,  the local Sysop can
  2553.      hit any key to enter chat mode.   To exit chat mode  the  local  Sysop
  2554.      must  hit the <Esc> key.   If no key is hit and the sample is finished
  2555.      being played then the "Sysop may chat interrupt  later..."  (line  38)
  2556.      message  is  given.   When  a user has paged the Sysop their name will
  2557.      turn red so that you can see that they have tried to call you.   Note:
  2558.      Sysops (access 5000) can page the local Sysop at any time.
  2559.  
  2560.  
  2561.      Function 4 - Set ANSI flag:
  2562.  
  2563.      This function allows the user to set their "ANSI" flag.   When  turned
  2564.      on, the BBS will send all ANSI colour codes.  When turned off, the BBS
  2565.      will automatically strip the  ANSI  colour  codes.   Forced  at  first
  2566.      "Guest" logon.
  2567.  
  2568.  
  2569.      Function 5 - Set CLS flag:
  2570.  
  2571.      This function allows the user to set their "CLS"  flag.   When  turned
  2572.      on,  the BBS will send the "Form Feed" (^L) code to clear the screen. 
  2573.      When turned off,  the BBS will strip the "Form Feed" code and send two
  2574.      "Carriage Return"'s instead.  Forced at first "Guest" logon.
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.      Chapter 5                    M A X's BBS                      Page: 42
  2581.  
  2582.  
  2583.  
  2584.  
  2585.      Chapter 5                    M A X's BBS                      Page: 43
  2586.  
  2587.      Function 6 - Set pause flag:
  2588.  
  2589.      This function allows the user to set their "Pause" flag.   When turned
  2590.      on,  the  BBS will pause when the user's screen is full.   When turned
  2591.      off,  the BBS will not pause.   Note:  You can force a pause using the
  2592.      auto  insert  code "%Z" (see "Customizing the BBS").   Forced at first
  2593.      "Guest" logon.
  2594.  
  2595.  
  2596.      Function 7 - Set Full Screen Editor flag:
  2597.  
  2598.      This  function allows the user to set their "Full Screen Editor" (FSE)
  2599.      flag.  When turned on, the full screen editor will be used for writing
  2600.      messages.  When turned off, the normal editor will be used for writing
  2601.      messages.  Forced at first "Guest" logon.
  2602.  
  2603.  
  2604.      Function 8 - Change # of lines per screen:
  2605.  
  2606.      This  function allows the user to set the number of lines per screen. 
  2607.      Used by the BBS to pause when the screen is full.   You can only enter
  2608.      values from 10 to 200.  Forced at first "Guest" logon.
  2609.  
  2610.  
  2611.      Function 9 - Change suburb:
  2612.  
  2613.      This function allows the user to change the suburb field of their user
  2614.      file.  Forced at first "Guest" logon.
  2615.  
  2616.  
  2617.      Function 10 - Change phone number:
  2618.  
  2619.      This function allows the user to change  the  phone  number  field  of
  2620.      their user file.  Forced at first "Guest" logon.
  2621.  
  2622.  
  2623.      Function 11 - Change computer description:
  2624.  
  2625.      This function allows the user to change the computer description field
  2626.      of their user file.  Forced at first "Guest" logon.
  2627.  
  2628.  
  2629.      Function 12 - Change password:
  2630.  
  2631.      This function allows the user to change their password.   The password
  2632.      is always invisible,  echoed as "." for each character.   The BBS will
  2633.      ask for the password to be typed again for verification before  making
  2634.      the change of password.  Forced at first "Guest" logon.
  2635.  
  2636.  
  2637.  
  2638.      Chapter 5                    M A X's BBS                      Page: 43
  2639.  
  2640.  
  2641.  
  2642.  
  2643.      Chapter 5                    M A X's BBS                      Page: 44
  2644.  
  2645.      Function 13 - Type a file (Filename):
  2646.  
  2647.      This function will print/send a text file.   The filename and path  is
  2648.      in the "Filename/Name/Dest" gadget.
  2649.  
  2650.  
  2651.      Function 14 - Type a file without pause (Filename):
  2652.  
  2653.      This function will print/send a text file  without  pausing  for  each
  2654.      full  screen,  whether  the  user's  "Pause" flag is set or not.   The
  2655.      filename and path is in the "Filename/Name/Dest" gadget.
  2656.  
  2657.  
  2658.      Function 15 - Print text (Line #):
  2659.  
  2660.      This  function  will  print/send a line of text from the text editor. 
  2661.      The "Extra" gadget contains the line number.  Use only the blank lines
  2662.      starting  from  the  last  line  upwards,  because as new upgrades are
  2663.      released they  will  use  the  next  blank  line  and  downwards,  and
  2664.      therefore will overwrite your text.
  2665.  
  2666.  
  2667.      Function 16 - Leave a message (Section, [Name])
  2668.  
  2669.      This a powerful function.   This function will let the user  edit  and
  2670.      save a message to a message section.   The user must have write access
  2671.      (the "Wr" flag) to use this function.  The "Extra" gadget contains the
  2672.      section in which the message will be stored.  The "Filename/Name/Dest"
  2673.      gadget contains an optional user name for whom the  message  is  for. 
  2674.      When  selected,  if the "Filename/Name/Dest" gadget does not contain a
  2675.      user name then the current user will be asked to enter the name of the
  2676.      user  the message is addressed to.   The user file is then searched to
  2677.      see if the user exists.  If the user does not exist they will be asked
  2678.      to  continue  or  abort.   The  user will then be asked to type in the
  2679.      subject of the message.   After the subject is  typed  in  either  the
  2680.      normal  editor  or the full screen editor will be started depending on
  2681.      the "FSE" flag.   A "Carriage Return" on a blank line will take you to
  2682.      the sub menu from the normal editor, or pressing <Esc> twice will take
  2683.      you to the sub menu  from  the  full  screen  editor.   The  sub  menu
  2684.      contains list,  edit, save, abort etc.  commands.   The sub menu has a
  2685.      text file called:
  2686.  
  2687.                                 MsgEdMenu.text
  2688.  
  2689.      See the message editor help files for descriptions  of  the  sub  menu
  2690.      commands and the full screen editor called:
  2691.  
  2692.                                 MsgEdHelp.text
  2693.                                 FSEHelp.text
  2694.  
  2695.  
  2696.      Chapter 5                    M A X's BBS                      Page: 44
  2697.  
  2698.  
  2699.  
  2700.  
  2701.      Chapter 5                    M A X's BBS                      Page: 45
  2702.  
  2703.      Note: The sub menu "(M)ove msg" command will only let the user see and
  2704.      use  message sections which the user has access to.   If replying to a
  2705.      message in an anonymous message section  ie.  "To"  and  "From"  flags
  2706.      turned  off,  then the user is not allowed to move that message into a
  2707.      different message section that may show who the message is  to.   This
  2708.      is a security measure.
  2709.  
  2710.  
  2711.      Function 17 - Read messages (Section, 100, 101 and 102 = linked)
  2712.  
  2713.      This a another powerful function.   This function will  let  the  user
  2714.      read messages from a message section.   The user must have read access
  2715.      (the "Rd" flag) to use this function.  The "Extra" gadget contains the
  2716.      section which the messages are read from.   Sections 100,  101 and 102
  2717.      mean linked message sections,  all sections  with  the  "Linked"  flag
  2718.      turned on are included in the message read (see "Sections configure").
  2719.      Section 100 means all linked  local  message  sections.   Section  101
  2720.      means all linked echo message sections.  Section 102 means both linked
  2721.      local and echo message sections.   Of course,  only the sections which
  2722.      the user has access to are used in the linked message sections.   When
  2723.      selected the message read sub menu is used  to  select  the  order  in
  2724.      which the user wishes to read the messages.   The first sub menu has a
  2725.      text file called:
  2726.  
  2727.                                 MsgRdMenu.text
  2728.  
  2729.      See the message read help file for descriptions of the first sub  menu
  2730.      commands called:
  2731.  
  2732.                                 MsgRdHelp.text
  2733.  
  2734.      The  second  sub  menu  seen  when the user selects "(S)earch msgs" is
  2735.      called:
  2736.  
  2737.                                 MsgSearchMenu.text
  2738.  
  2739.      When a message is displayed the "From" and "To"  fields  are  optional
  2740.      and  are  set  in  the  "Sections  configure" window.   When searching
  2741.      messages the "From" and "To" flags must be turned on to be included in
  2742.      the search.   The user has the following options after the message has
  2743.      been printed/sent:
  2744.  
  2745.        (-) Read previous:   (if any)  This lets the user read the  previous
  2746.      message  or the message that the current message is a reply to.  Note:
  2747.      If the message has been deleted then the "Message not found" (line 83)
  2748.      message  is  given.   If the message is private (Section 0) and is not
  2749.      addressed to or from the user,  then the "Message  is  private"  (line
  2750.      111)  message  is  given.   A  "Carriage  Return"  will  return to the
  2751.      original message.
  2752.  
  2753.  
  2754.      Chapter 5                    M A X's BBS                      Page: 45
  2755.  
  2756.  
  2757.  
  2758.  
  2759.      Chapter 5                    M A X's BBS                      Page: 46
  2760.  
  2761.        (+) Read reply:  (if any)  This lets the user read the reply to this
  2762.      message.   If there is more than one reply then the BBS will only show
  2763.      the first one it finds.   If you wish to read  all  the  replies  then
  2764.      select "(T)hreads" from the sub menu.   Note:  If the message has been
  2765.      deleted then the "Message not found" (line 83) message is  given.   If
  2766.      the message is private (Section 0) and is not addressed to or from the
  2767.      user,  then the "Message is private" (line 111) message is  given.   A
  2768.      "Carriage Return" will return to the original message.
  2769.  
  2770.        (B)efore:   This  command allows the user to go back to the messages
  2771.      that they were reading before.   It has a ten message history and when
  2772.      you  have  reached  the  tenth  message selecting "(B)efore" will only
  2773.      reprint the tenth message.   A "Carriage Return" will  return  to  the
  2774.      original message.
  2775.  
  2776.        (N)ext:  This allows the user to continue to the next message in the
  2777.      order selected in the sub menu.   A "Carriage Return" will also do the
  2778.      same.
  2779.  
  2780.        (C)ontinuous:  This lets the user read messages continuously without
  2781.      waiting  for  a  response  from  the  user.    Page  full  pausing  is
  2782.      automatically  disabled.   This command will continue until the end of
  2783.      the messages is reached, or "(C)ontinuous" is pressed again.
  2784.  
  2785.        (A)gain:  This will reprint/resend the current message.
  2786.  
  2787.        (R)eply:  This will let the user reply to the message.   The "From",
  2788.      "To",  and  "Subject"  fields  will automatically be filled in.   This
  2789.      command is similar to the BBS menu function 16 - Leave a message  (see
  2790.      above), the user will return to the sub commands when finished writing
  2791.      the reply.
  2792.  
  2793.        (M)ark:  This will let the user mark/un-mark the current message for
  2794.      later  retrieval.   Messages  are  automatically marked when the logon
  2795.      mail search is performed.
  2796.  
  2797.        (D)elete:  This will let the user delete the message.  Messages "To"
  2798.      or  "From"  that  user can be deleted by the user only if the "Delete"
  2799.      flag is turned on in the  "Sections  configure"  window,  and  if  the
  2800.      message  is  not  locked.   Note:  Sysops (access 5000) can delete any
  2801.      message.
  2802.  
  2803.        (L)ock:  This is a Sysop command to roll lock/un-lock this message.
  2804.  
  2805.        (F)orward:   This is a Sysop command to  forward  a  message.   This
  2806.      command  lets  you  forward  a  message to another user and/or message
  2807.      section and allows you to change the subject of  the  message.   Note:
  2808.      You can not forward a message into an echo message section.
  2809.  
  2810.  
  2811.  
  2812.      Chapter 5                    M A X's BBS                      Page: 46
  2813.  
  2814.  
  2815.  
  2816.  
  2817.      Chapter 5                    M A X's BBS                      Page: 47
  2818.  
  2819.        (E)dit:   This is a Sysop command used to edit the user file of  the
  2820.      person  who wrote the message.   Similar to the BBS menu function 26 -
  2821.      Edit a user (see below).
  2822.  
  2823.        (S)top:   This will let the user stop reading messages and return to
  2824.      the BBS menu.
  2825.  
  2826.  
  2827.      Function 18 - List/Search user file:
  2828.  
  2829.      This function will let the user either list all the users in the  user
  2830.      file in alphabetical order, or search for a user by entering a name or
  2831.      text search string.   The search is not  case  sensitive  and  partial
  2832.      strings are accepted.
  2833.  
  2834.  
  2835.      Function 19 - Print caller log:
  2836.  
  2837.      This function will let the user view the caller log.  It is similar to
  2838.      the pull down menu function "Caller log".   Note: If an alias is used,
  2839.      then it is possible for a user to find the true name of  the  user  by
  2840.      viewing the caller log.
  2841.  
  2842.  
  2843.      Function 20 - List files (Section, 100 = linked):
  2844.  
  2845.      This function will list the files in  a  file  section.   The  "Extra"
  2846.      gadget contains the file section.   Section 100 means linked sections,
  2847.      all sections with the "Linked" flag turned  on  are  included  in  the
  2848.      listing (see "Sections configure").   Only the sections which the user
  2849.      has access to are used in the linked  sections.   When  selected,  the
  2850.      list  files  sub  menu  is  used to select the order in which the user
  2851.      wishes to list the files.  The sub menu has a text file called:
  2852.  
  2853.                                 ListFilesMenu.text
  2854.  
  2855.      See the list files help file for descriptions of the sub menu commands
  2856.      called:
  2857.  
  2858.                                 ListFilesHelp.text
  2859.  
  2860.  
  2861.      Function 21 - Delete a file (Section, 100 = linked):
  2862.  
  2863.      This function will let the user delete a file which they have uploaded
  2864.      only  if  the  "Delete"  flag is turned on in the "Sections configure"
  2865.      window,  and if the file is not locked.   The "Extra" gadget  contains
  2866.      the  file  section.   Section 100 means linked sections,  all sections
  2867.      with the "Linked" flag turned on are included in the  search  for  the
  2868.      file  to  delete  (see "Sections configure").   Partial strings can be
  2869.  
  2870.      Chapter 5                    M A X's BBS                      Page: 47
  2871.  
  2872.  
  2873.  
  2874.  
  2875.      Chapter 5                    M A X's BBS                      Page: 48
  2876.  
  2877.      used for the filename search.  If a partial string is used and the BBS
  2878.      finds a match,  then the user is asked "Is this correct?" (line 256). 
  2879.      Select either "Y" for yes,  "N" for no or "S"  to  stop  the  search. 
  2880.      Note: Sysops (access 5000) can delete any file.
  2881.  
  2882.  
  2883.      Function 22 - Read a file (Section, 100 = linked):
  2884.  
  2885.      This function lets the user read a file from the  file  library.   The
  2886.      "Extra"  gadget  contains the file section.   Section 100 means linked
  2887.      sections,  all sections with the "Linked" flag turned on are  included
  2888.      in  the  search  for  the file to be read (see "Sections configure"). 
  2889.      Partial strings can be used for the filename  search.   If  a  partial
  2890.      string  is used and the BBS finds a match,  then the user is asked "Is
  2891.      this correct?" (line 256).   Select either "Y" for yes,  "N" for no or
  2892.      "S"  to stop the search.   The BBS will first check the file to see if
  2893.      it is a printable text file.  If the file is not a printable text file
  2894.      then  the  message "Not a printable file" (line 196) is given.   Note:
  2895.      "New" files can not be  read  by  users  (except  Sysops)  until  made
  2896.      public.
  2897.  
  2898.  
  2899.      Function 23 - Upload files (Section):
  2900.  
  2901.      This function lets the user upload a file to your file  library.   The
  2902.      term "Upload" is used because the host computer ie. M A X's BBS is the
  2903.      master computer,  and can be considered as on  a  higher  level.   The
  2904.      user's  computer  is  the slave computer and can be considered as on a
  2905.      lower level.  Therefore an upload is a file going from the lower level
  2906.      computer  (the user's),  to the higher level computer (the BBS).   The
  2907.      term download (see BBS menu function 24  -  Download  a  file,  below)
  2908.      means  a  file going from the higher level computer (the BBS),  to the
  2909.      lower level computer (the user's).   The "Extra" gadget  contains  the
  2910.      file section in which the file is going to be stored.  A user can only
  2911.      upload a file when they have upload access (the "Up" flag).   The user
  2912.      can  only  perform  file transfers in the time slot set in the "System
  2913.      configure" window.  When selected and the user does not have a default
  2914.      file transfer protocol (protocol 0), then a sub menu is used to select
  2915.      the file transfer protocol to use for the upload.   The sub menu has a
  2916.      text file called:
  2917.  
  2918.                                 ProtocolMenu.text
  2919.  
  2920.      See the protocol help file for descriptions of the protocols available
  2921.      called:
  2922.  
  2923.                                 ProtocolHelp.text
  2924.  
  2925.      If the user runs out of time during an upload then the BBS  will  wait
  2926.      until the transfer is finished, and add one extra minute to the user's
  2927.  
  2928.      Chapter 5                    M A X's BBS                      Page: 48
  2929.  
  2930.  
  2931.  
  2932.  
  2933.      Chapter 5                    M A X's BBS                      Page: 49
  2934.  
  2935.      time remaining for every file uploaded.   This allows the user time to
  2936.      enter  the  file  description.   After  a  file  or  files  have  been
  2937.      transferred the BBS will  ask  the  user  for  a  description  of  the
  2938.      file(s).   If  the  user  exits the BBS (lost carrier) before the file
  2939.      description is entered for all files,  then the BBS will ask the  user
  2940.      for  the file description(s) during the next login (see the "GFD" flag
  2941.      in the "User editor").  Also see "File transfer" below.  Note:  Sysops
  2942.      (access 5000) can upload a file at any time.
  2943.  
  2944.  
  2945.      Function 24 - Download files (Section, 100 = linked, [Filename]):
  2946.  
  2947.      This function lets the user download a file from  the  file  library. 
  2948.      This  will  probably  be  the most used function.   The "Extra" gadget
  2949.      contains the file section.   Section 100 means  linked  sections,  all
  2950.      sections  with  the "Linked" flag turned on are included in the search
  2951.      for the file to be downloaded  (see  "Sections  configure").   Partial
  2952.      strings  can be used for the filename search.   If a partial string is
  2953.      used and the BBS finds a match,  then  the  user  is  asked  "Is  this
  2954.      correct?" (line 256).  Select either "Y" for yes, "N" for no or "S" to
  2955.      stop  the  search.    An   optional   filename   can   used   in   the
  2956.      "Filename/Name/Dest" gadget.   When the filename is given the BBS will
  2957.      skip the filename search and proceed straight into the file  transfer.
  2958.      The file must be found in one of the three files file paths.  The file
  2959.      does not have to be in the file library data file.   If the file is in
  2960.      the file library data file, then the download count will be updated on
  2961.      completion of the download.  A user can only download a file when they
  2962.      have download access (the "Dn" flag).   The user can only perform file
  2963.      transfers in the time slot set in the "System configure"  window,  and
  2964.      can  only  download  a file if their download/upload ratio allows (see
  2965.      "User editor").   The user can not download "New" files until they are
  2966.      made  public,  and can only download a file when they have enough time
  2967.      remaining for the transfer.  When selected, and the user does not have
  2968.      a default file transfer protocol (protocol 0), then a sub menu is used
  2969.      to select the file transfer protocol to be used for the download.  The
  2970.      sub menu has a text file called:
  2971.  
  2972.                                 ProtocolMenu.text
  2973.  
  2974.      See the protocol help file for descriptions of the protocols available
  2975.      called:
  2976.  
  2977.                                 ProtocolHelp.text
  2978.  
  2979.      With the batch file transfer protocols (YModem,  ZModem) a maximum  of
  2980.      ten  files  can  be  downloaded in a batch.   Also see "File transfer"
  2981.      below.   Note:  Sysops (access 5000) can download any  file  including
  2982.      "New" files at any time.
  2983.  
  2984.  
  2985.  
  2986.      Chapter 5                    M A X's BBS                      Page: 49
  2987.  
  2988.  
  2989.  
  2990.  
  2991.      Chapter 5                    M A X's BBS                      Page: 50
  2992.  
  2993.      Function 25 - Make "New" file public (Section, 100 = linked):
  2994.  
  2995.      This function allows the user (Sysop) to make a  "New"  file  publicly
  2996.      available  to  normal  users.   The  "Extra"  gadget contains the file
  2997.      section.   Section 100 means linked sections,  all sections  with  the
  2998.      "Linked"  flag turned on are included in the search for the file to be
  2999.      made public (see "Sections configure").   Partial strings can be  used
  3000.      for  the  filename  search.   If  a partial string is used and the BBS
  3001.      finds a match,  then the user is asked "Is this correct?" (line 256). 
  3002.      Select either "Y" for yes, "N" for no or "S" to stop the search.
  3003.  
  3004.  
  3005.      Function 26 - Edit a user:
  3006.  
  3007.      This function allows the user (Sysop) to edit  another  user's  file. 
  3008.      The BBS will ask the current user for the user's name to edit, and the
  3009.      user file is searched.  If the user is not found then the BBS will ask
  3010.      for the name of the user again.  When the user that is being edited is
  3011.      found,  their user file is displayed.   The editor is similar  to  the
  3012.      other  user  editors,  so  only a brief description is given here (see
  3013.      "User editor").   The BBS will ask for which line  to  edit  or  enter
  3014.      options  "m"  to  make  the  user  a  Member,  "x" to exit (aborts any
  3015.      changes) and "s" to save changes.   For security reasons when  editing
  3016.      the  user's access level,  the access level can only be lower than the
  3017.      current users access level.  Also the current user can not edit a user
  3018.      with  the  same or higher access as they have.   When editing a user's
  3019.      flags use "*" to set the flag,  "-" to clear the flag and "." to leave
  3020.      the  flag  as  is.   Partial flag edit lines are accepted.   Note:  An
  3021.      Almighty Sysop (access 10000) can edit any user and  give  any  access
  3022.      level.
  3023.  
  3024.  
  3025.      Function 27 - Execute external program (1 = args, Filename):
  3026.  
  3027.      This function will execute an external program.  If the "Extra" gadget
  3028.      contains  a "1" then the arguments (see below) are added to the end of
  3029.      the filename.   The gadget "Filename/Name/Dest" contains the  filename
  3030.      and path of the file to be executed.  This function is intended to run
  3031.      external games and utilities.   To write a program for  this  function
  3032.      the  program must open the serial device in shared mode.   The program
  3033.      can choose whether or not to use the  following  arguments  (an  ASCII
  3034.      string  appended to the filename with arguments separated with a space
  3035.      and null terminated):
  3036.  
  3037.        "User name  (spaces  changed  to  underscore),  Access  level,  Time
  3038.      remaining,  Bps rate, Page length, Line feeds (always Y), local (Y/N),
  3039.      ANSI (Y/N), Pause (Y/N), Cls (Y/N)"
  3040.  
  3041.      Here is an example argument line:
  3042.  
  3043.  
  3044.      Chapter 5                    M A X's BBS                      Page: 50
  3045.  
  3046.  
  3047.  
  3048.  
  3049.      Chapter 5                    M A X's BBS                      Page: 51
  3050.  
  3051.                         M_A_X 10000 120 9600 28 Y N Y Y Y
  3052.  
  3053.      The external program must  keep  track  of  time  remaining  and  lost
  3054.      carriers.   When  the program returns to the BBS,  the BBS will make a
  3055.      time remaining adjustment (going by the change in the system clock, if
  3056.      any) to the user, and  will hang-up if out of time.
  3057.  
  3058.  
  3059.      Function 28 - CLI:
  3060.  
  3061.      This function allows the user (Sysop) to  use  the  AmigaDOS  commands
  3062.      similar  to  the Amiga's "CLI".   This function works in the following
  3063.      way;  after you have entered the command,  the BBS will  execute  that
  3064.      command  and  redirect  the output (which would normally go to a "CLI"
  3065.      window) to a file called:
  3066.  
  3067.                                 RAM:MAXsBBSFunct28.output
  3068.  
  3069.      When the control returns back to the BBS a  time  adjustment  is  made
  3070.      (going  by the change in the system clock,  if any) to the user.   The
  3071.      output file above is then printed/sent.   This  function  should  work
  3072.      with  any AmigaDOS command or program that normally outputs to a "CLI"
  3073.      window.  Note: Some programs may require extra input when executed and
  3074.      it  may  therefore  never return to the BBS,  they will wait for extra
  3075.      input from the local keyboard or mouse.   It is recommended  that  you
  3076.      experiment  with this function at a local login before you try it from
  3077.      remote.
  3078.  
  3079.  
  3080.      Function 29 - Deposit to the time bank:
  3081.  
  3082.      This  function  allows  the  user  to  subtract  time  from their time
  3083.      remaining and add it (deposit) to their time bank.   The user can then
  3084.      later  withdraw  from  the  time  bank  into their time remaining (see
  3085.      below).   The user can only deposit to a  maximum  time  bank  balance
  3086.      specified in the "System configure" window.   If the time bank balance
  3087.      is at the maximum then a message "Time bank balance is too high" (line
  3088.      240) is given.
  3089.  
  3090.  
  3091.      Function 30 - Withdraw from the time bank:
  3092.  
  3093.      This function allows the user to add time to their time  remaining  by
  3094.      withdrawing  time from their time bank.   Note:  If the pull down menu
  3095.      function "Countdown" has been activated then the message "Sysop  needs
  3096.      to  use  the  computer"  (line 249) is given.   The BBS will take into
  3097.      account the next system event when the user tries to withdraw time.
  3098.  
  3099.  
  3100.  
  3101.  
  3102.      Chapter 5                    M A X's BBS                      Page: 51
  3103.  
  3104.  
  3105.  
  3106.  
  3107.      Chapter 5                    M A X's BBS                      Page: 52
  3108.  
  3109.      Function 31 - Deposit all time remaining and log out:
  3110.  
  3111.      This function is similar to the BBS menu function 29 - Deposit to  the
  3112.      time  bank  (see  above),  except  all  the  user's  time remaining is
  3113.      deposited to the time bank leaving only one minute.  The BBS will then
  3114.      do a formal log out as described in BBS menu function 1 - Log out.
  3115.  
  3116.  
  3117.      Function 32 - Send a private echo message (n, [Dest address], [Name]):
  3118.  
  3119.      This function is used to generate a private "NetMail" message to later
  3120.      be  picked  up  by  or  sent  to the destination FidoNet system.   The
  3121.      "Extra" gadget contains an argument.   Use a "0" to tell  the  BBS  to
  3122.      first  check  the destination address entered by the user to see is if
  3123.      it exists in the "FidoNet mail distribution" window.   Use  a  "1"  to
  3124.      tell the BBS not to check the destination address entered by the user.
  3125.      Use a "2"  to  tell  the  BBS  that  the  "Filename/Name/Dest"  gadget
  3126.      contains  the  destination FidoNet address.   The "Filename/Name/Dest"
  3127.      gadget can contain an optional user name for the message,  except when
  3128.      argument "2" is used.   All private mail must be sent straight to,  or
  3129.      be picked up by the destination FidoNet system.  Private "NetMail" can
  3130.      not  be sent indirectly to the destination as the message would not be
  3131.      private.
  3132.  
  3133.  
  3134.      Function 33 - Set default file transfer protocol:
  3135.  
  3136.      This function allows the user to set a default file transfer protocol.
  3137.      If the user always uses the same file transfer protocol, then they can
  3138.      specify  that  protocol in their user file.   The BBS will not have to
  3139.      ask which file transfer protocol  they  wish  to  use  every  time  an
  3140.      upload/download is selected.   See the "User editor" for a list of the
  3141.      protocols available.   This file is printed/sent when this function is
  3142.      selected:
  3143.  
  3144.                                 ProtocolList.text
  3145.  
  3146.  
  3147.      File transfer:
  3148.  
  3149.      When a file  transfer  has  been  started  the  BBS  opens  the  "File
  3150.      transfer"  window.   A  file  transfer  can  be aborted at any time by
  3151.      clicking on the "Close window" gadget.   The BBS may  not  respond  to
  3152.      your  abort request straight away,  but it will eventually (click once
  3153.      and wait).  Here is the information displayed in this window:
  3154.  
  3155.        Protocol:   This shows which protocol is being  used  for  the  file
  3156.      transfer  (XModem,   YModem,  ZModem).    Definition:   Protocols  are
  3157.      agreements between people or processes about  which  may  do  what  to
  3158.      whom, and when.
  3159.  
  3160.      Chapter 5                    M A X's BBS                      Page: 52
  3161.  
  3162.  
  3163.  
  3164.  
  3165.      Chapter 5                    M A X's BBS                      Page: 53
  3166.  
  3167.        Filename:   This  is  the  filename  of  the  file  currently  being
  3168.      transferred.
  3169.  
  3170.        Size:   This  is  the  size  in  bytes  of  the file currently being
  3171.      transferred.
  3172.  
  3173.        Total blocks:   This is the total number of blocks for  the  current
  3174.      file  being  transferred.   Block  sizes  change  depending  on  which
  3175.      protocol is being used.   With the ZModem protocol the block size  can
  3176.      change during the file transfer when errors are detected (see "Errors"
  3177.      below).  Note: For batch downloads the initial number of blocks is the
  3178.      total number of blocks for the batch transfer.
  3179.  
  3180.        Estimated  time:   This  is  the estimated time for the current file
  3181.      being transferred.   The estimated time depends on the bps  rate  that
  3182.      the  user  is connected at.   This is only an estimate,  and if errors
  3183.      occur during the file transfer then the transfer  will  take  longer. 
  3184.      The estimated time was calculated on the average characters per second
  3185.      rate for each protocol at 2400 bps.  This time is used to check that a
  3186.      user  has enough time remaining to complete the file transfer.   Note:
  3187.      For batch downloads the initial estimated time is the  estimated  time
  3188.      for the batch transfer.
  3189.  
  3190.        Actual  time:   This is the actual time (timer) for the current file
  3191.      being transferred.   The actual time is in real  seconds  ie.  updated
  3192.      every second.  The timer starts from when the transfer window is first
  3193.      opened.  Some file transfer programs only update the actual time after
  3194.      each block.   Some blocks can take up to thirty three seconds to send!
  3195.      Therefore it may look like there is no activity for this time.
  3196.  
  3197.        Bytes:   This is the number of bytes  transferred  so  far  for  the
  3198.      current  file.   With  the  ZModem protocol this may not start at zero
  3199.      because the receiving side of a ZModem transfer can start the transfer
  3200.      at any position.  The ZModem protocol can also change the current file
  3201.      position at any time during the transfer.
  3202.  
  3203.        Blocks:   This is the number of blocks transferred so  far  for  the
  3204.      current  file.   With  the  ZModem  protocol the block size can change
  3205.      during the file  transfer  when  errors  are  detected  (see  "Errors"
  3206.      below).
  3207.  
  3208.        Errors in this block:   This is the number of errors detected in the
  3209.      file transfer (due to line noise) for this block.  If the total number
  3210.      of  errors in a block is higher than ten (six for the ZModem protocol)
  3211.      then the transfer is aborted.  Note: For ZModem send this field is not
  3212.      used as the ZModem protocol can change the file position when an error
  3213.      is detected, ie. may not be the same block.
  3214.  
  3215.        Errors:   This is the total number of errors so far for the  current
  3216.      file  being  transferred.   Errors  are  caused  by line noise and are
  3217.  
  3218.      Chapter 5                    M A X's BBS                      Page: 53
  3219.  
  3220.  
  3221.  
  3222.  
  3223.      Chapter 5                    M A X's BBS                      Page: 54
  3224.  
  3225.      detected by Cyclic Redundancy Checks (CRC).   The CRC is performed  on
  3226.      the block being transferred before and after the transmission,  if the
  3227.      CRC's do not match then an error has occurred with  the  block  during
  3228.      the  transmission,  the  block  is  then  re-sent.   When an error has
  3229.      occurred in a ZModem download  the  block  size  will  become  smaller
  3230.      (minimum 256 bytes) as successive errors are detected.  This helps the
  3231.      file transfer time on very noisy lines.
  3232.  
  3233.        Chars per second:   This is the characters per second rate  for  the
  3234.      current  file  transfer.   The  "CPS"  gauge  is  accurate  to  twenty
  3235.      milliseconds.   If errors occur during a file transfer then the  "CPS"
  3236.      rate will drop.   If you are multi-tasking the BBS with other programs
  3237.      then this will also slow down the  file  transfer.   When  calculating
  3238.      maximum  characters per second for file transfers,  remember that each
  3239.      character has 1 start bit plus 8 data bits plus 1 stop bit.   Giving a
  3240.      total of 10 bits per character.  Therefore a 2400 bps rate will give a
  3241.      maximum of:
  3242.  
  3243.                          2400 / 10 = 240 characters per second.
  3244.  
  3245.        Last ZModem  header:   This  line  is  only  used  for  ZModem  file
  3246.      transfers.  It displays the last ZModem frame type and position/flags.
  3247.      This may be useful for debugging a ZModem program or to  give  you  an
  3248.      idea of how the ZModem protocol works.
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.      Chapter 5                    M A X's BBS                      Page: 54
  3277.  
  3278.  
  3279.  
  3280.  
  3281.      Chapter 6                    M A X's BBS                      Page: 55
  3282.  
  3283.                               CUSTOMIZING THE BBS
  3284.                               -------------------
  3285.  
  3286.      M  A  X's BBS is supplied with sample menus and text files to give you
  3287.      an idea of the features that M A X's BBS has.  You may wish to use the
  3288.      BBS  as it is.   Most users do not want to call a BBS which is exactly
  3289.      the  same  as  one  already  online.   Therefore  it  is  up  to  your
  3290.      imagination and needs as to what group of users you wish to attract to
  3291.      your BBS.   M A X's BBS was written with the concept of being able  to
  3292.      completely customize the look and feel of the BBS.  All the text files
  3293.      can be edited with any text editor.   You can also add your  own  text
  3294.      files.   All  menus  have  separate  text files.   All BBS text can be
  3295.      edited with the "Text editor" function (see "Configuring  the  BBS"). 
  3296.      In  fact  you  could  even  change the language of the BBS!   Here are
  3297.      descriptions of the default text files used by the BBS:
  3298.  
  3299.        BBS.text:   This is the file seen when the BBS is waiting for a call
  3300.      (idle).
  3301.  
  3302.        Bulletin.text:   This  is the file seen by the users after they have
  3303.      logged on.   The user will only see this if the "Bulletin" flag is not
  3304.      set, ie.  when you make an update to the news bulletin, use the global
  3305.      edit function to force all users to read the new  news  bulletin  (see
  3306.      "User editor").
  3307.  
  3308.        FSEHelp.text:   This  is  the full screen editor help file seen when
  3309.      the user selects the help option in the full  screen  editor.   It  is
  3310.      recommended that you only change the ANSI colours in this file.
  3311.  
  3312.        Guest.text:   This  is  the  file seen by a new or "Guest" user when
  3313.      they have logged on your BBS for the  first  time.   This  file  would
  3314.      normally  contain  introduction  and  membership  information  for new
  3315.      users.
  3316.  
  3317.        Intro.text:  This is the file seen be all users just after they have
  3318.      logged   in.    This  file  would  normally  contain  information  and
  3319.      statistics about the user.
  3320.  
  3321.        ListFilesHelp.text:   This is the BBS menu function 20 - List files,
  3322.      the file seen when the user selects the help option from the sub menu.
  3323.      It is recommended that you only change the ANSI colours in this file.
  3324.  
  3325.        ListFilesMenu.text:   This is the sub menu file  for  the  BBS  menu
  3326.      function  20 - List files.   The selection keys can not be changed and
  3327.      it is intended that you only change the look and colours.
  3328.  
  3329.        LockOut.text:   This is the file seen by a user who has been  locked
  3330.      out of your BBS (access 0).  Better change this!
  3331.  
  3332.  
  3333.  
  3334.      Chapter 6                    M A X's BBS                      Page: 55
  3335.  
  3336.  
  3337.  
  3338.  
  3339.      Chapter 6                    M A X's BBS                      Page: 56
  3340.  
  3341.        LogIn.text:   This is the file seen by the user when the user  first
  3342.      connects  to  your  BBS.   You should change this to the name that you
  3343.      intend  to  call  your  BBS.    Note:   Pause  is  turned   off   when
  3344.      printing/sending this file.
  3345.  
  3346.        LogOut.text:   This  is  the file seen by the user with the BBS menu
  3347.      function 1 - Log out.  Note: Pause is turned off when printing/sending
  3348.      this file.
  3349.  
  3350.        MsgEdHelp.text:  This is the BBS menu function 16 - Leave a message,
  3351.      the file seen when the user selects the help option from the sub menu.
  3352.      It is recommended that you only change the ANSI colours in this file.
  3353.  
  3354.        MsgEdMenu.text:  This is the sub menu file for the BBS menu function
  3355.      16 - Leave a message.  The selection keys can not be changed and it is
  3356.      intended that you only change the look and colours.
  3357.  
  3358.        MsgRdHelp.text:   This  is the BBS menu function 17 - Read messages,
  3359.      the file seen when the user selects the help option from the sub menu.
  3360.      It is recommended that you only change the ANSI colours in this file.
  3361.  
  3362.        MsgRdMenu.text:   This  is  the first sub menu file for the BBS menu
  3363.      function 17 - Read messages.   The selection keys can not  be  changed
  3364.      and it is intended that you only change the look and colours.
  3365.  
  3366.        MsgSearchMenu.text:   This  is second sub menu file for the BBS menu
  3367.      function 17 - Read messages.   This menu is seen when the user selects
  3368.      "(S)earch  msgs" from the first sub menu.   The selection keys can not
  3369.      be changed and it is intended  that  you  only  change  the  look  and
  3370.      colours.
  3371.  
  3372.        ProtocolHelp.text:    This   is   the  BBS  menu  function  23/24  -
  3373.      Upload/download a file,  the protocol help file  seen  when  the  user
  3374.      selects the help option from the sub menu.  It is recommended that you
  3375.      only change the ANSI colours in this file.
  3376.  
  3377.        ProtocolList.text:   This is the BBS menu function 33 - Set  default
  3378.      file  transfer  protocol,  the  file  seen  when the user selects this
  3379.      function.
  3380.  
  3381.        ProtocolMenu.text:  This is the sub menu protocol selection file for
  3382.      the BBS menu functions 23/24 - Upload/download a file.   The selection
  3383.      keys can not be changed and it is intended that you  only  change  the
  3384.      look and colours.
  3385.  
  3386.  
  3387.      ANSI codes:
  3388.  
  3389.      M A X's BBS supports all  the  ANSI  colour  codes  plus  some  cursor
  3390.      movement  codes.   All  ANSI  codes  begin  with  these two characters
  3391.  
  3392.      Chapter 6                    M A X's BBS                      Page: 56
  3393.  
  3394.  
  3395.  
  3396.  
  3397.      Chapter 6                    M A X's BBS                      Page: 57
  3398.  
  3399.      "Escape" (^[) and  "[",  the  following  codes  are  optional  numbers
  3400.      separated  by a semi colon (;) and terminated with an "m" for a colour
  3401.      code, "A,  B,  C,  or D" for a delta cursor movement or "H" for cursor
  3402.      position.   The  colour  codes  can  be  as  long  as you like and are
  3403.      terminated with the "m" character.
  3404.  
  3405.                         eg:
  3406.  
  3407.                               <Esc>[n;n...m
  3408.  
  3409.                               <Esc> - the "Escape" (^[) character
  3410.                               [ - The "[" character
  3411.                               n - A number (see below)
  3412.                               ; - Separates numbers
  3413.                               m - Terminates the ANSI colour code
  3414.  
  3415.      Where the "n" is a number representing a colour  or  attribute.   Here
  3416.      are the available colours:
  3417.  
  3418.                               30 - Black foreground
  3419.                               31 - Red foreground
  3420.                               32 - Green foreground
  3421.                               33 - Yellow foreground
  3422.                               34 - Blue foreground
  3423.                               35 - Magenta foreground
  3424.                               36 - Cyan foreground
  3425.                               37 - White foreground
  3426.                               40 - Black background
  3427.                               41 - Red background
  3428.                               42 - Green background
  3429.                               43 - Yellow background
  3430.                               44 - Blue background
  3431.                               45 - Magenta background
  3432.                               46 - Cyan background
  3433.                               47 - White background
  3434.  
  3435.      Here are the available attributes:
  3436.  
  3437.                0 - All attributes off (normal white on black)
  3438.                1 - Bold on (high intensity)
  3439.                3 - Italics on
  3440.                4 - Underscore on
  3441.                5 - Blink on (or italic if flashing text is turned off)
  3442.                7 - Reverse video on (swaps foreground and background)
  3443.  
  3444.      For  a  delta cursor movement the ANSI string is similar to the above,
  3445.      except that you can only have one number and the termination character
  3446.      gives the direction of movement:
  3447.  
  3448.                               A - Cursor move up by n (north)
  3449.  
  3450.      Chapter 6                    M A X's BBS                      Page: 57
  3451.  
  3452.  
  3453.  
  3454.  
  3455.      Chapter 6                    M A X's BBS                      Page: 58
  3456.  
  3457.                               B - Cursor move down by n (south)
  3458.                               C - Cursor move right by n (east)
  3459.                               D - Cursor move left by n (west)
  3460.  
  3461.                         eg:
  3462.  
  3463.                               <Esc>[10A
  3464.  
  3465.                               The cursor will move up by ten lines
  3466.  
  3467.      For  cursor  position  the  ANSI  string  is  terminated  by  the  "H"
  3468.      character:
  3469.  
  3470.                         eg:
  3471.  
  3472.                               <Esc>[n1;n2H
  3473.  
  3474.                               n1 - Row (line)
  3475.                               n2 - Column
  3476.  
  3477.      If the number for both delta cursor movement and cursor  position  are
  3478.      zero (0) or omitted, then they will default to one (1).
  3479.  
  3480.  
  3481.      Auto insert:
  3482.  
  3483.      M A X's BBS will automatically insert text into  any  BBS  menu,  text
  3484.      file or BBS text.   There are forty seven auto inserts available.   To
  3485.      insert text the character "%" is used followed by the  character  code
  3486.      representing  the  insert to be placed there.   If you wish to use the
  3487.      "%" character without an auto insert then use two "%" characters  (you
  3488.      will  only  see  one).   It is recommended that you print out the auto
  3489.      insert summary file as a quick look-up called:
  3490.  
  3491.                                 AutoInsert.text
  3492.  
  3493.      Here is the list of auto inserts available:
  3494.  
  3495.                               %a - Sysop name (line 0)
  3496.                               %b - Full date & time
  3497.                               %c - Date
  3498.                               %d - Time
  3499.                               %e - Talking clock
  3500.  
  3501.                               %f - User name
  3502.                               %R - User first name
  3503.                               %g - Suburb
  3504.                               %h - Phone number
  3505.                               %i - Computer description
  3506.                               %j - Comment
  3507.  
  3508.      Chapter 6                    M A X's BBS                      Page: 58
  3509.  
  3510.  
  3511.  
  3512.  
  3513.      Chapter 6                    M A X's BBS                      Page: 59
  3514.  
  3515.                               %k - Time remaining
  3516.                               %l - Access
  3517.                               %u - Status
  3518.                               %m - Time limit
  3519.                               %n - D/U ratio
  3520.                               %o - Last message read
  3521.                               %p - Page length
  3522.                               %q - # of calls
  3523.                               %r - # of messages
  3524.                               %s - # of uploads
  3525.                               %t - # of downloads
  3526.                               %M - Time bank
  3527.                               %N - File transfer protocol
  3528.                               %O - Future
  3529.                               %v - Last on date & time
  3530.                               %w - bps rate
  3531.  
  3532.                               %x - Total calls
  3533.                               %y - Number of users
  3534.                               %z - Active messages
  3535.                               %A - Lowest message
  3536.                               %B - Highest message
  3537.                               %C - Active files
  3538.                               %D - Calls today
  3539.                               %E - Messages today
  3540.                               %F - Files today
  3541.                               %G - Guests today
  3542.                               %Q - Imports today
  3543.  
  3544.                               %H - Last user's name
  3545.                               %I - Last logon date & time
  3546.                               %J - Date & time user logged on
  3547.                               %K - Elapsed time
  3548.                               %L - Percentage time used
  3549.                               %P - Mins before next system event
  3550.  
  3551.                               %X - Forces hangup
  3552.                               %Y - Waits for a second
  3553.                               %Z - Forces a pause
  3554.  
  3555.  
  3556.      Hiding parts of text:
  3557.  
  3558.      Parts  of  menus  or  parts  of any text file can be hidden from users
  3559.      depending on  their  access  level.   This  is  useful  to  hide  menu
  3560.      functions from users who do not have access to them,  and hiding parts
  3561.      of news bulletins with information you do not want some users to  see.
  3562.      This  is  how  it  works;  the  "@" character is followed by an access
  3563.      level.   Only users with the same or higher access level can  see  the
  3564.      text  following  the "@n" code.   If you want to use the character "@"
  3565.  
  3566.      Chapter 6                    M A X's BBS                      Page: 59
  3567.  
  3568.  
  3569.  
  3570.  
  3571.      Chapter 6                    M A X's BBS                      Page: 60
  3572.  
  3573.      without an access level check,  then use two "@" characters (you  will
  3574.      only  see one).   Here is an example to hide the text "Only sysops can
  3575.      see this" from users with an access level of less than 5000:
  3576.  
  3577.                         eg:
  3578.  
  3579.                               @5000Only sysops can see this@0
  3580.  
  3581.      Put an access level check of zero ("@0") after the part  of  the  text
  3582.      you  are  hiding,  so that all users can see the remaining part of the
  3583.      text file.
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.      Chapter 6                    M A X's BBS                      Page: 60
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.       Special thanks to my EX-fiance Tina Blue for her time, patience and
  3645.       help in proof reading and correcting this manual!  Thanks Teens!
  3646.  
  3647.                   "Life's a bitch and I ALMOST married one!"
  3648.  
  3649.                 Fido and FidoNet are trademarks of Tom Jennings.
  3650.